メモ : このメソッドを有効に利用するには、下位要素でオーバーライドする必要があります。
ロガーはそれぞれ、1 つのカテゴリに属します。 慣例では、これらのカテゴリは、ロガーが使用される完全修飾クラス名にマッピングされます。 例えば、
次に実際の使用例を示します。
var traceLogger:ILoggingTarget = new TraceTarget();
traceLogger.filters = ["mx.rpc.~~", "mx.messaging.~~"];
Log.addTarget(traceLogger);
メモ：これは、フレームワークから呼び出されるメソッドです。このメソッドを直接呼び出さないでください。
メモ：これは、フレームワークから呼び出されるメソッドです。このメソッドを直接呼び出さないでください。
ロガーはそれぞれ、1 つのカテゴリに属します。 慣例では、これらのカテゴリは、ロガーが使用される完全修飾クラス名にマッピングされます。 例えば、
var traceLogger:ILoggingTarget = new TraceTarget();
traceLogger.filters = [ "mx.rpc.~~", "mx.messaging.~~" ];
Log.addTarget(traceLogger);
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.debug("here is some channel info {0} and {1}", 15.4, true);
// This will log the following String:
// "here is some channel info 15.4 and true"
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.error("here is some channel info {0} and {1}", 15.4, true);
// This will log the following String:
// "here is some channel info 15.4 and true"
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.fatal("here is some channel info {0} and {1}", 15.4, true);
// This will log the following String:
// "here is some channel info 15.4 and true"
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.info("here is some channel info {0} and {1}", 15.4, true);
// This will log the following String:
// "here is some channel info 15.4 and true"
ロギング対象として指定するストリングでは、ロギング前にストリング内に挿入する追加パラメーターを示すインデックスを中括弧（{ }）で囲んで指定することができます。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.log(LogEventLevel.DEBUG, "here is some channel info {0} and {1}", LogEventLevel.DEBUG, 15.4, true);
// This will log the following String as a DEBUG log message:
// "here is some channel info 15.4 and true"
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
// Get the logger for the mx.messaging.Channel "category"
// and send some data to it.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.warn("here is some channel info {0} and {1}", 15.4, true);
// This will log the following String:
// "here is some channel info 15.4 and true"
ロガーは、特定のカテゴリの情報用に作成されたシングルトンインスタンスです。 通常、カテゴリは、情報を記録する必要があるコンポーネントのパッケージ名です。 カテゴリにより、ユーザーは興味のあるログ情報を指定できます。複数のカテゴリを選択したり、正規表現で組み合わせることができます。 これにより、広範囲なログ情報と絞り込んだログ情報の両方を取得できます。 例えば、mx.messaging パッケージと mx.rpc パッケージ配下のすべてのログ情報を取得し、これらのパッケージの出力を XML でフォーマットしたいとします。 サブパッケージやコンポーネントを含む、mx.messaging カテゴリ配下のすべてのログ情報を取得するには、mx.messaging.~~ などのワイルドカード表現が必要になります。詳細は、以下のコード例を参照してください。
ターゲットは、記録対象のデータの出力メカニズムを提供します。 通常このメカニズムには、フォーマット、転送、保存などがありますが、VM 配下の任意のものを使用できます。 次の 2 種類のターゲットが提供されています。
...
import mx.logging.targets.
import mx.logging.
private function initLogging():void {
// Create a target.
var logTarget:TraceTarget = new TraceTarget();
// Log only messages for the classes in the mx.rpc.and
// mx.messaging packages.
logTarget.filters=["mx.rpc.,"mx.messaging.];
// Log all log levels.
logTarget.level = LogEventLevel.ALL;
// Add date, time, category, and log level to the output.
logTarget.includeDate = true;
logTarget.includeTime = true;
logTarget.includeCategory = true;
logTarget.includeLevel = true;
// Begin logging.
Log.addTarget(logTarget);
}
...
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
ロギング対象として指定するストリングでは、ロギング前にストリング内に挿入する追加パラメーターを示すインデックスを中括弧（{ }）で囲んで指定することができます。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。
ログに指定するストリングには、インデックスを持つ中括弧を含めることができます。このインデックスで、記録する前に挿入する追加パラメーターを示します。 例えば、10 と 15 をパラメーターとして呼び出すと、"the first additional parameter was {0} the second was {1}" は "the first additional parameter was 10 the second was 15" に変換されます。