ログおよびトレース・アナライザーは、以下のロギング・ ユーティリティーに、スタンドアロンおよびプラグインの サポートを提供します。
このサポート内容は、以下のとおりです。
このサポートは、以下のプラグインによって提供され ます。
ロギング・ユーティリティー |
プラグイン |
---|---|
Java ロギング (JSR-047) |
org.eclipse.hyades.logging.java14 |
Apache Jakarta 共通ロギング |
org.eclipse.hyades.logging.commons |
Apache Jakarta Log4J ロギング |
org.eclipse.hyades.logging.log4j |
以下のセクションでは、各タイプのロギング・ ユーティリティーのサポートの詳細について説明し、使用方法 を例で示すサンプルへのポインターを提供します。
org.eclipse.hyades.logging.java14 パッケージの下にある java.util.logging.LogRecord クラスの拡張機能 によって 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent を java.util.logging.LogRecord でロギング するための、カスタマイズ・ログ・レコードを作成することが できます。この org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord は java.util.logging.LogRecord を拡張して 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent への参照を含めます。すべての java.util.logging.LogRecord プロパティーは 1 つ以上の共通ベース・イベント・プロパティーにマップ されて、非共通ベース・イベントを認識するハンドラーと フォーマッターに対する反射性を維持します。
org.eclipse.hyades.logging.java14 パッケージの下の java.util.logging.Filter インターフェースを実装することによってのみ 、org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord を正常にログに記録することができます。
org.eclipse.hyades.logging.java14 パッケージの下にある java.util.logging.Formatter 抽象クラスの 拡張機能では、ハンドラーがorg.eclipse.hyades.logging.java14.CommonBaseEventLogRecord および java.util.logging.LogRecord ログ・ メッセージを XML にフォーマットするよう構成することが できます。この org.eclipse.hyades.logging.java14.XmlFormatter フォーマッターは 、org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord または java.util.logging.LogRecord ログ・ メッセージを、共通ベース・イベント v1.0.1 スキーマを基に した XML に変換します。フォーマット時に 、org.eclipse.hyades.logging.core.IExternalizableToXml インターフェース (例えば 、org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord など) を実装しているかどうかを確認するためにログ・ メッセージがチェックされます。実装している場合は、XML シリアライゼーションの代わり に、externalizeCanonicalXmlString() API が 呼び出されます。実装していない場合は 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent と同じマッピングを使用して 、java.util.logging.LogRecord ログ・ メッセージが共通ベース・イベント・オブジェクトに変換 され、externalizeCanonicalXmlString() API を 呼び出すことによって XML に直列化されます。
org.eclipse.hyades.logging.java パッケージ
の下にある、java.util.logging.Handler 抽象
クラスの拡張機能では
、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent
および java.util.logging.LogRecord ログ・
メッセージをロギング・エージェントにログするように、
ロガーを構成することができます。
この org.eclipse.hyades.logging.java.LoggingAgentHandler ハンドラーは、ロガーに記録される org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord または java.util.logging.LogRecord ログ・ メッセージを、ロガーとハンドラーのフィルターとロギング・ レベルを基に、ログに記録できるかどうかをチェックします。 ログ・メッセージがログに記録される場合は、メッセージを ログに記録するロガーと同じ名前でロギング・エージェントが 解決されます。そうでない場合には 、org.eclipse.hyades.logging.java.SingleLoggingAgentHandler ハンドラーを使用すると、ロギング・エージェント・ ハンドラーという名前のロギング・エージェントが 1 つ作成 されます。メッセージは 、org.eclipse.hyades.logging.java.XmlFormatter を使用して XML でフォーマットされ、ロギング・エージェント に書き込まれます。
実例のためのサンプル
Java ロギング (JSR-047) のサポートの利用方法を 示すサンプルが提供され、このサンプルでは、Java ロギング (JSR-047) に対するスタンドアロンおよびプラグインの サポートの新規および既存のユーザーが必要とする構成と 計測装置について説明します。詳しくは、 「ファイル」>「新規」>「サンプル...」>「Hyades ロギング」 >「Hyades JSR-047 ロギング・サンプル」を開いてください。
org.eclipse.hyades.logging.commons パッケージの下の org.apache.commons.logging.Log インターフェースを実装すると 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object および java.lang.Throwable ログ・メッセージ をログに記録するためのロガーを作成することができます。 この org.eclipse.hyades.logging.commons.Logger は、ロガーに記録される org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object または java.lang.Throwable ログ・ メッセージを、ロガーのロギング・レベルを基に、ログに記録 できるかどうかをチェックします。ログ・メッセージがログ に記録される場合 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object または java.lang.Throwable ログ・メッセージ は、フォーマットされてログに記録されます。 org.apache.commons.logging.LogFactory 抽象 クラスの実装が提供され 、org.eclipse.hyades.logging.commons.Logger インスタンスに固有のプロキシー・ファクトリーが表されます。 この org.eclipse.hyades.logging.commons.LoggerFactory プロキシー・ファクトリーは、1 つ以上の異なるタイプの ロガーとそのファクトリーが、それぞれ別のクラス・ローダー で必要とされ、すべて同じ Apache 共通バイナリーを 使用している複数のクラス・ローダー環境で使用することを 意図されたものです。
org.eclipse.hyades.logging.commons.Logger は 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object および java.lang.Throwable ログ・メッセージ を、共通ベース・イベント v1.0.1 スキーマを基にした XML に フォーマットします。フォーマット時に 、org.eclipse.hyades.logging.core.IExternalizableToXml インターフェース (例えば 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent など) を実装しているかどうかを確認するためにログ・ メッセージがチェックされます。実装している場合は、XML シリアライゼーションの代わり に、externalizeCanonicalXmlString() API が 呼び出されます。実装していない場合は 、org.eclipse.hyades.internal.logging.core.XmlGenerator を使用して 、java.lang.Object または java.lang.Throwable ログ・メッセージが共通 ベース・イベント・オブジェクトに変換され 、externalizeCanonicalXmlString() API を 呼び出すことによって XML に直列化されます。
org.eclipse.hyades.logging.commons.Logger は 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object および java.lang.Throwable ログ・メッセージ を、ロギング・エージェントに記録します。 ログ・メッセージがログに記録される場合は、メッセージを ログに記録するロガーと同じ名前でロギング・エージェントが 解決されます。メッセージは、XML にフォーマットされ、 ロギング・エージェントに書き込まれます。
org.eclipse.hyades.logging.commons パッケージの下の org.apache.commons.logging.Log インターフェースを実装すると 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object および java.lang.Throwable ログ・メッセージ をローカル・ファイルに記録するためのロガーを作成すること ができます。この org.eclipse.hyades.logging.commons.FileLogger は、ロガーに記録される org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object または java.lang.Throwable ログ・ メッセージを、ロガーのロギング・レベルを基に、ログに記録 できるかどうかをチェックします。ログ・メッセージがログ に記録される場合 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object または java.lang.Throwable ログ・メッセージ は、XML にフォーマットされてローカル・ファイルに記録 されます。 org.apache.commons.logging.LogFactory 抽象 クラスの実装が提供され 、org.eclipse.hyades.logging.commons.FileLogger インスタンスに固有のプロキシー・ファクトリーが表されます。 この org.eclipse.hyades.logging.commons.FileLoggerFactory プロキシー・ファクトリーは、1 つ以上の異なるタイプの ロガーとそのファクトリーが、それぞれ別のクラス・ローダー で必要とされ、すべて同じ Apache 共通バイナリーを 使用している複数のクラス・ローダー環境で使用することを 意図されたものです。
実例のためのサンプル
Apache Jakarta 共通ロギングのサポートの利用方法 を示すサンプルが提供され、このサンプルでは、Apache Jakarta 共通ロギングに対するスタンドアロンおよび プラグインのサポートの新規および既存のユーザーが必要と する構成と計測装置について説明します。詳しくは、 「ファイル」>「新規」>「サンプル...」>「Hyades ロギング」 >「Hyades Apache 共通ロギング・サンプル」を参照してください。
org.apache.log4j.spi.LoggingEvent ログ・ メッセージのメッセージ・プロパティーでは 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent をログに記録することができます。
org.eclipse.hyades.logging.log4j パッケージ の下の org.apache.log4j.spi.Filter 抽象 クラスの拡張機能によってのみ 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent を正常にログに記録することができます。
org.eclipse.hyades.logging.log4j パッケージ の下にある、org.apache.log4j.Layout 抽象 クラスの拡張機能では 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent および org.apache.log4j.spi.LoggingEvent ログ・メッセージを XML にフォーマットするように、 アペンダーを構成することができます。この org.eclipse.hyades.logging.log4j.XmlLayout フォーマッターは 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent または org.apache.log4j.spi.LoggingEvent ログ・メッセージを、共通ベース・イベント v1.0.1 スキーマ を基にした XML に変換します。フォーマット時に 、org.apache.log4j.spi.LoggingEvent の メッセージ・プロパティーが org.eclipse.hyades.logging.core.IExternalizableToXml インターフェース (例えば 、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent など) を実装しているかどうかを確認するためにログ・ メッセージがチェックされます。実装している場合は、XML シリアライゼーションの代わり に、externalizeCanonicalXmlString() API が 呼び出されます。実装していない場合は 、org.eclipse.hyades.internal.logging.core.XmlGenerator を使用して 、org.apache.log4j.spi.LoggingEvent ログ・ メッセージが共通ベース・イベント・オブジェクトに変換され 、externalizeCanonicalXmlString() API を 呼び出すことによって XML に直列化されます。
org.eclipse.hyades.logging.log4j
パッケージの下にある
、org.apache.log4j.AppenderSkeleton 抽象
クラスの拡張機能では
、org.eclipse.hyades.logging.events.cbe.CommonBaseEvent
および org.apache.log4j.spi.LoggingEvent
ログ・メッセージをロギング・エージェントに記録するように、
ロガーを構成することができます。
この org.eclipse.hyades.logging.log4j.LoggingAgentAppender アペンダーは、ロガーに記録される org.eclipse.hyades.logging.events.cbe.CommonBaseEvent および org.apache.log4j.spi.LoggingEvent ログ・メッセージを、ロガーとアペンダーのフィルターと ロギング・レベルを基に、ログに記録できるかどうかを チェックします。ログ・メッセージがログに記録される場合 は、メッセージをログに記録するロガーと同じ名前でロギング ・エージェントが解決されます。そうでない場合には 、org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender アペンダーを使用すると、ロギング・エージェント・ アペンダーという名前のロギング・エージェントが 1 つ作成 されます。メッセージは 、org.eclipse.hyades.logging.log4j.XmlLayout を使用して XML にフォーマットされ、ロギング・エージェント に書き込まれます。
実例のためのサンプル
Apache Jakarta Log4J ロギングのサポートの利用 方法を示すサンプルが提供され、このサンプルでは、Apache Jakarta Log4J ロギングに対するスタンドアロンおよび プラグインのサポートの新規および既存のユーザーが必要と する構成と計測装置について説明します。詳しくは、 「ファイル」>「新規」>「サンプル...」>「Hyades ロギング」 >「Hyades Apache Log4J ロギング・サンプル」を参照してください。
関連概念
共通ベース・イベント・モデル
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.