WebSphere Application Server ロガーの構成

WebSphere® Application Server ロガーを使用するようにアプリケーションを構成するには、いくつかの方法があります。

アプリケーションに最も適した構成のタイプは、以下により異なります。

アプリケーションの「クラス・ローダー順序」設定が Classes loaded with parent class loader first (Parent First) または Classes loaded with application class loader first (Parent Last) のいずれであるか。クラス・ローダー委任モードは、コンソールの「クラス・ロードおよび更新の検出 (Class loading and update detection)」ページで設定できます。
Jakarta Commons Logging が、アプリケーション構成でバンドルされているかどうか
Jakarta Commons Logging が、アプリケーション内で提供されているかどうか

以下の表では、アプリケーションが WebSphere Application Server ロガーを使用できるようにするために必要な条件について説明します。

クラス・ローダー・モードは `Parent First` で、Jakarta Commons Logging がアプリケーションにバンドルされている

表 1. ロガーを使用するために必要な条件。「親が最初」であり、Jakarta Commons Logging がアプリケーションにバンドルされている場合。
Jakarta Commons Logging の構成	LogFactory インスタンス	Log インスタンス	コメント
アプリケーションは、以下のいずれかによって、構成を提供します。親クラス・ローダーが WebSphere プロパティー・ファイルを最初に検出するため、アプリケーション・クラスパス内のプロパティー・ファイル `commons-logging.properties` は、 LogFactory によって読み取られません。クラス名は、次のファイルから読み取られます。 `META-INF/services/ org.apache.commons .logging.LogFactory`	使用されるログ・ファクトリーは、アプリケーションまたはモジュールの META-INF ファイルに構成が指定されていない限り、 WebSphere Application Server のデフォルト構成で指定された LogFactory 実装です。	使用されるログは、以下のいずれかです。 WebSphere Application Server のデフォルト構成で指定された Log 実装異なる Log 実装をインスタンス化する、アプリケーション固有の LogFactory が使用される場合は、アプリケーション固有の Log 実装。	アプリケーション親クラス・ローダーは、 Jakarta Commons Logging コードをロードするための最初のクラス・ローダーです。 Jakarta Commons Logging をサポートする WebSphere バンドルは、 LogFactory 構成属性を検索する LogFactory 静的コード提供します。静的 LogFactory コートが、アプリケーション構成で指定される LogFactory インスタンスをインスタンス化するには、 LogFactory インスタンスは、親クラス・ローダーのクラスパス上になければなりません。
アプリケーションで提供されていない	使用されるログ・ファクトリーは、WebSphere デフォルト構成で指定される LogFactory 実装です。	使用されるログは、WebSphere デフォルト構成で指定される Log 実装です。	アプリケーションでバンドルされる Jakarta Commons Logging は使用されません。

クラス・ローダー・モードが `Parent First` で、Jakarta Commons Logging がアプリケーションにバンドルされていない

表 2. ロガーを使用するために必要な条件。「親が最初」であり、Jakarta Commons Logging がアプリケーションにバンドルされていない場合。
Jakarta Commons Logging の構成	LogFactory インスタンス	Log インスタンス	コメント
アプリケーションは、以下のいずれかによって、構成を提供します。親クラス・ローダーが最初に WebSphere Application Server プロパティー・ファイルを検出するため、 LogFactory による `commons-logging.properties` アプリケーション・クラスパス内の読み取られていないプロパティー・ファイル。クラス名は、次のファイルから読み取られます。 `META-INF/services/ org.apache.commons .logging.LogFactory`	使用されるログ・ファクトリーは、アプリケーションまたはモジュールの META-INF ファイルに構成が指定されていない限り、 WebSphere Application Server のデフォルト構成で指定された LogFactory 実装です。	使用されるログは、以下のいずれかです。 WebSphere Application Server のデフォルト構成で指定された Log 実装異なる Log 実装をインスタンス化する、アプリケーション固有の LogFactory が使用される場合は、アプリケーション固有の Log 実装。	アプリケーション親クラス・ローダーは、 Jakarta Commons Logging コードをロードするための最初のクラス・ローダーです。 Jakarta Commons Logging をサポートする WebSphere バンドルは、 LogFactory 構成属性を検索する LogFactory 静的コード提供します。静的 LogFactory コートが、アプリケーション構成で指定される LogFactory インスタンスをインスタンス化するには、 LogFactory インスタンスは、親クラス・ローダーのクラスパス上になければなりません。
アプリケーションで提供されていない	使用されるログ・ファクトリーは、 WebSphere Application Server のデフォルト構成で指定された LogFactory 実装です。	使用されるログは、 WebSphere Application Server のデフォルト構成で指定されたログ実装です。	前の行と同じ

クラス・ローダー・モードは `Parent Last` で、Jakarta Commons Logging がアプリケーションにバンドルされている

表 3. ロガーを使用するために必要な条件。「親が最後」であり、Jakarta Commons Logging がアプリケーションにバンドルされている場合。
Jakarta Commons Logging の構成	LogFactory インスタンス	Log インスタンス	コメント
アプリケーションは、以下のいずれかによって、構成を提供します。クラス・ローダーがアプリケーション・プロパティー・ファイルを最初に検出するため、アプリケーション・クラスパス内のプロパティー・ファイル `commons-logging.properties` は、LogFactory によって読み取られます。クラス名は、次のファイルから読み取られます。 `META-INF/services/ org.apache.commons .logging.LogFactory`	使用されるログ・ファクトリーは、以下のいずれかです。デフォルトの Jakarta Commons Logging LogFactory アプリケーション構成で指定される LogFactory	使用されるログは、アプリケーション構成で指定される Log 実装。使用されるログ・ファクトリーがデフォルトの Jakarta Commons Logging LogFactory である場合、Log 実装はアプリケーション・クラス・ローダーのクラスパス上になければなりません。	アプリケーション・クラス・ローダーは、 Jakarta Commons Logging コードをロードするための最初のローダーです。 Jakarta Commons Logging をサポートするアプリケーション・バンドルは、 LogFactory 構成属性を検索する LogFactory 静的コードを提供します。静的 LogFactory コードが、アプリケーション構成で指定される LogFactory インスタンスをインスタンス化するには、 LogFactory インスタンスは、アプリケーション・クラス・ローダーのクラスパス上になければなりません。
アプリケーションで提供されていない	使用されるログ・ファクトリーは、 WebSphere Application Server のデフォルト構成で指定された LogFactory 実装です。	使用されるログは、 WebSphere Application Server のデフォルト構成で指定されたログ実装です。

クラス・ローダー・モードが `Parent Last` で、Jakarta Commons Logging がアプリケーションにバンドルされていない

表 4。ロガーを使用するために必要な条件。「親が最後」であり、Jakarta Commons Logging がアプリケーションにバンドルされていない場合。
Jakarta Commons Logging の構成	LogFactory インスタンス	Log インスタンス	コメント
アプリケーションは、以下のいずれかによって、構成を提供します。クラス・ローダーがアプリケーション・プロパティー・ファイルを最初に検出するため、アプリケーション・クラスパス内のプロパティー・ファイル `commons-logging.properties` は、LogFactory によって読み取られます。クラス名は、次のファイルから読み取られます。 `META-INF/services/ org.apache.commons .logging.LogFactory`	使用されるログ・ファクトリーは、以下のいずれかです。デフォルトの Jakarta Commons Logging LogFactory アプリケーション構成で指定される LogFactory	使用されるログは、アプリケーション構成で指定される Log 実装。使用されるログ・ファクトリーがデフォルトの Jakarta Commons Logging LogFactory である場合、Log 実装はアプリケーション・クラス・ローダーのクラスパス上になければなりません。	アプリケーション・クラス・ローダーには Jakarta Commons Logging コードはありません。したがって、Jakarta Commons Logging をサポートする WebSphere バンドルは、LogFactory 構成属性を検索する LogFactory 静的コードを提供します。静的 LogFactory コートが、アプリケーション構成で指定される LogFactory インスタンスをインスタンス化するには、 LogFactory インスタンスは、親クラス・ローダーのクラスパス上になければなりません。
アプリケーションで提供されていない	使用されるログ・ファクトリーは、 WebSphere Application Server のデフォルト構成で指定された LogFactory 実装です。	使用されるログは、 WebSphere Application Server のデフォルト構成で指定されたログ実装です。