LogManager クラス

定義

[Android.Runtime.Register("java/util/logging/LogManager", DoNotGenerateAcw=true)]
public class LogManager : Java.Lang.Object

[<Android.Runtime.Register("java/util/logging/LogManager", DoNotGenerateAcw=true)>]
type LogManager = class
    inherit Object

継承

Object

JavaObject

Object

LogManager

属性

RegisterAttribute

注釈

ロガーとログ サービスに関する一連の共有状態を維持するために使用される 1 つのグローバル LogManager オブジェクトがあります。

この LogManager オブジェクト: <ul><li> Logger オブジェクトの階層型名前空間を管理します。 名前付きロガーはすべて、この名前空間に格納されます。 <li> ログ コントロールプロパティのセットを管理します。 これらは単純なキーと値のペアであり、ハンドラーやその他のログ オブジェクトが自身を構成するために使用できます。 </ul>

グローバル LogManager オブジェクトは、LogManager.getLogManager() を使用して取得できます。 LogManager オブジェクトは、クラスの初期化中に作成され、その後変更することはできません。

起動時に、LogManager クラスは java.util.logging.manager システム プロパティを使用して配置されます。

LogManager では、初期構成を制御できる 2 つの省略可能なシステム プロパティが定義されています。 <ul><li>"java.util.logging.config.class" <li>"java.util.logging.config.file" </ul> これら 2 つのプロパティは、コマンド ラインで "java" コマンドに指定することも、JNI_CreateJavaVMに渡すシステム プロパティ定義として指定することもできます。

"java.util.logging.config.class" プロパティが設定されている場合、プロパティ値はクラス名として扱われます。 指定されたクラスが読み込まれ、オブジェクトがインスタンス化され、そのオブジェクトのコンストラクターが初期構成での読み取りを担当します。 (そのオブジェクトは、その構成を制御するために他のシステム プロパティを使用する場合があります)。代替構成クラスでは、 readConfiguration(InputStream) を使用して LogManager のプロパティを定義できます。

"java.util.logging.config.class" プロパティが <b>not</b> 設定されている場合は、"java.util.logging.config.file" システム プロパティを使用してプロパティ ファイルを指定できます (java.util.Properties 形式)。 初期ログ記録の構成は、このファイルから読み取られます。

これらのプロパティのいずれも定義されていない場合、LogManager は既定の構成を使用します。 既定の構成は、通常、Java インストール ディレクトリのプロパティ ファイル "lib/logging.properties" から読み込まれます。

ロガーとハンドラーのプロパティの名前は、ハンドラーまたはロガーのドット区切りの名前で始まります。

グローバル ログ プロパティには、 <ul><li>A プロパティ "handlers" が含まれる場合があります。 これにより、ルート ロガー ("" という名前のロガー) でハンドラーとして読み込んで登録するハンドラー クラスのクラス名の空白またはコンマ区切りのリストが定義されます。 各クラス名は、既定のコンストラクターを持つ Handler クラス用である必要があります。 これらのハンドラーは、最初に使用されるときに遅延して作成される可能性があることに注意してください。

liA プロパティ "。handlers"。 これにより、指定されたロガーにハンドラーとして読み込んで登録するハンドラー クラスのクラス名の空白またはコンマ区切りのリストが定義されます。 各クラス名は、既定のコンストラクターを持つ Handler クラス用である必要があります。 これらのハンドラーは、最初に使用されるときに遅延して作成される可能性があることに注意してください。

liA プロパティ "。useParentHandlers"。 これにより、ブール値が定義されます。 既定では、すべてのロガーは、ログ メッセージ自体の処理に加えて親を呼び出します。これにより、多くの場合、ルート ロガーによってメッセージが処理されます。 このプロパティを false に設定する場合は、このロガーのハンドラーを構成する必要があります。それ以外の場合、ログ メッセージは配信されません。

<li>A プロパティ "config"。 このプロパティは、任意の構成コードの実行を許可するためのものです。 このプロパティは、クラス名の空白またはコンマ区切りのリストを定義します。 名前付きクラスごとに新しいインスタンスが作成されます。 各クラスの既定のコンストラクターは、ロガー レベルの設定、ハンドラーの追加、フィルターの追加など、ログ構成を更新する任意のコードを実行 </ul>

LogManager の構成中に読み込まれるすべてのクラスは、ユーザー クラス パスの前のシステム クラス パスで最初に検索されることに注意してください。 これには、LogManager クラス、任意の構成クラス、およびハンドラー クラスが含まれます。

ロガーは、ドット区切りの名前に基づいて名前付け階層に編成されます。 したがって、"a.b.c" は "a.b" の子ですが、"a.b1" と a.b2" はピアです。

名前が ".level" で終わるすべてのプロパティは、ロガーのログ レベルを定義するものと見なされます。 したがって、"foo.level" は、"foo" というロガーのログ レベルを定義し、名前付け階層内の任意の子に対して (再帰的に) 定義します。 ログ レベルは、プロパティ ファイルで定義されている順序で適用されます。 したがって、ツリー内の子ノードのレベル設定は、親の設定の後に配置する必要があります。 プロパティ名 ".level" を使用して、ツリーのルートのレベルを設定できます。

LogManager オブジェクトのすべてのメソッドは、マルチスレッド セーフです。

1.4 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。