Logger クラス

リファレンス

定義

名前空間:: Java.Util.Logging

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。

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

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

継承: Object

Object
Logger

属性: RegisterAttribute

注釈

Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。ロガーには通常、階層的なドット区切り名前空間を使用して名前が付けられます。ロガー名は任意の文字列にすることができますが、通常は、java.net や javax.swing など、ログに記録されたコンポーネントのパッケージ名またはクラス名に基づく必要があります。さらに、Logger 名前空間に格納されていない "匿名" ロガーを作成することもできます。

ロガーオブジェクトは、getLogger ファクトリメソッドの呼び出しによって取得できます。これらは、新しいロガーを作成するか、適切な既存のロガーを返します。ロガーへの厳密な参照が保持されていない場合、ファクトリメソッドの getLogger 1 つによって返されるロガーはいつでもガベージコレクションされる可能性があることに注意してください。

ログメッセージは登録済みの Handler オブジェクトに転送され、コンソール、ファイル、OS ログなど、さまざまな宛先にメッセージを転送できます。

各ロガーは、Logger 名前空間の最も近い既存の先祖である "親" ロガーを追跡します。

各ロガーには、"レベル" が関連付けられています。これは、このロガーが考慮する最小レベルを反映しています。ロガーのレベルが設定 nullされている場合、その有効なレベルはその親から継承され、その後、その親から再帰的に取得される可能性があります。

ログレベルは、LogManager クラスの説明で説明されているように、ログ構成ファイルのプロパティに基づいて構成できます。ただし、Logger.setLevel メソッドの呼び出しによって動的に変更される場合もあります。ロガーのレベルが変更された場合、そのレベルを持つ子ロガーは null 親から有効なレベルを継承するため、変更が子ロガーにも影響する可能性があります。

各ログの呼び出しで、ロガーは最初に、ロガーの有効なログレベルに対して要求レベル (SEVERE や FINE など) の安いチェックを実行します。要求レベルがログレベルより低い場合、ログの呼び出しはすぐに返されます。

この初期 (安価な) テストに合格すると、ロガーはログメッセージを記述する LogRecord を割り当てます。その後、Filter (存在する場合) を呼び出して、レコードを公開する必要があるかどうかをより詳細に確認します。それが渡された場合は、LogRecord を出力ハンドラーに発行します。既定では、ロガーは親のハンドラーにも公開し、ツリーを再帰的に上に発行します。

各ロガーに ResourceBundle 関連付けられている場合があります。名前 ResourceBundle 、ファクトリメソッド、 #getLogger(java.lang.String, java.lang.String) または値で指定できます。メソッドを #setResourceBundle(java.util.ResourceBundle) setResourceBundle 使用します。このバンドルは、ログメッセージのローカライズに使用されます。ロガーに独自 ResourceBundle のバンドル名またはリソースバンドル名がない場合は、親からまたはリソースバンドル名を継承 ResourceBundle し、ツリーを再帰的に上に継承します。

ほとんどのロガー出力メソッドは、"msg" 引数を受け取ります。この msg 引数には、生の値またはローカライズキーを指定できます。書式設定中に、ロガーがローカライズ ResourceBundle を持っている (または継承する) 場合、およびメッセージ文字列のマッピングがある場合 ResourceBundle 、メッセージ文字列はローカライズされた値に置き換えられます。それ以外の場合は、元のメッセージ文字列が使用されます。通常、フォーマッタは java.text.MessageFormat スタイルの書式設定を使用してパラメーターを書式設定するため、書式指定文字列 "{0}{1}" は 2 つのパラメーターを文字列として書式設定します。

一連のメソッドは、"msg" 引数の代わりに "msgSupplier" を受け取ります。これらのメソッドは、メッセージが実際に有効なログレベルに基づいてログに記録される場合にのみ、必要なログメッセージを構築するために呼び出される関数を受け取ります Supplier<String> 。これにより、不要なメッセージの構築が排除されます。たとえば、開発者が診断のためにシステムの正常性状態をログに記録し、文字列を受け入れるバージョンを使用する場合、コードは次のようになります。

<code>

               class DiagnosisMessages {
                 static String systemHealthStatus() {
                   // collect system health information
                   ...
                 }
               }
               ...
               logger.log(Level.FINER, DiagnosisMessages.systemHealthStatus());
</code>

上記のコードでは、ログレベル FINER が無効になっている場合でも、正常性状態が不必要に収集されます。以下のような仕入先受け入れバージョンでは、ログレベル FINER が有効になっている場合にのみ状態が収集されます。

<code>

               logger.log(Level.FINER, DiagnosisMessages::systemHealthStatus);
</code>

ResourceBundle検索時に、ロガーはまず、バンドルが使用して指定されたかどうかを調べます。次に、ファクトリメソッドを使用#setResourceBundle(java.util.ResourceBundle) setResourceBundleして#getLogger(java.lang.String, java.lang.String) getLoggerリソースバンドル名が指定されたかどうかのみが確認されます。リソースバンドル名が見つからない ResourceBundle 場合、または見つからない場合は、親ツリーから継承された最も近い ResourceBundle 名前またはリソースバンドル名が使用されます。<br> a ResourceBundle がメソッドを通じて #setResourceBundle(java.util.ResourceBundle) setResourceBundle 継承または指定された場合、それが ResourceBundle 使用されます。それ以外の場合、ロガーにリソースバンドル名のみが含まれるか継承されている場合、そのリソースバンドル名は、ログ記録時の ResourceBundle 既定のロケールを使用してオブジェクトにマップされます。 <br id="ResourceBundleMapping">リソースバンドル名をオブジェクトに ResourceBundle マッピングする場合、ロガーは最初に Thread の java.lang.Thread#getContextClassLoader() コンテキストクラスローダーを使用して、指定されたリソースバンドル名を ResourceBundle. スレッドコンテキストクラスローダーの場合は null、代わりに java.lang.ClassLoader#getSystemClassLoader() システムクラスローダーを試します。 ResourceBundleまだ見つからない場合は、ファクトリメソッドの最初の呼び出し元のクラスローダーを#getLogger(java.lang.String, java.lang.String) getLogger使用します。

書式設定 (ローカライズを含む) は、通常フォーマッタを呼び出す出力ハンドラーの役割です。

書式設定は同期的に行う必要はありません。 LogRecord が実際に外部シンクに書き込まれるまで、遅延する可能性があります。

ログ方法は、次><の 5 つの主要なカテゴリにグループ化されています。 <>

ログレベル、メッセージ文字列、および必要に応じてメッセージ文字列にいくつかのパラメーターを受け取る一連の "log" メソッドがあります。 <李>

"log" メソッドに似た一連の "logp" メソッド ("log precise" の場合) がありますが、明示的なソースクラス名とメソッド名も受け取ります。 <李>

"logp" メソッドのような一連の "logrb" メソッド ("リソースバンドルを含むログ" の場合) がありますが、ログメッセージのローカライズに使用するために明示的なリソースバンドルオブジェクトも受け取ります。 <李>

メソッドエントリ ("entering" メソッド)、メソッドの戻り値 ("終了" メソッド)、および例外のスロー ("スロー" メソッド) をトレースするための便利なメソッドがあります。 <李>

最後に、開発者が特定のログレベルで単純な文字列をログに記録するだけの場合に、非常に単純なケースで使用するための便利なメソッドのセットがあります。これらのメソッドは、標準のレベル名 ("severe"、"warning"、"info"など) の後に名前が付けられ、1 つの引数、メッセージ文字列を受け取ります。 </ul>

明示的なソース名とメソッド名を受け取らないメソッドの場合、ログ記録フレームワークは、ログ記録メソッドに呼び出されるクラスとメソッドを決定するための "ベストエフォート" を行います。ただし、この自動的に推論される情報はおおよその情報 (またはまったく間違っている可能性があります) のみである可能性があることに注意することが重要です。仮想マシンは、JITing 時に広範な最適化を実行でき、スタックフレームを完全に削除できるため、呼び出し元のクラスとメソッドを確実に見つけることができなくなります。

Logger のすべてのメソッドは、マルチスレッドセーフです。

<b>サブクラス化情報:</b> LogManager クラスは、名前空間内の任意のポイントに対して名前付きロガーの独自の実装を提供する場合があることに注意してください。したがって、Logger のサブクラス (新しい LogManager クラスと組み合わせて実装されている場合を除く) は、LogManager クラスから Logger インスタンスを取得するように注意する必要があり、"isLoggable" や "log(LogRecord)" などの操作をそのインスタンスに委任する必要があります。すべてのログ出力をインターセプトするために、サブクラスは log(LogRecord) メソッドのみをオーバーライドする必要があることに注意してください。他のすべてのログメソッドは、この log(LogRecord) メソッドの呼び出しとして実装されます。

1.4 で追加されました。

の Java ドキュメントjava.util.logging.Logger

このページの一部は、Android オープンソースプロジェクトによって作成および共有され、クリエイティブコモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

Logger(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。
Logger(String, String)	名前付きサブシステムのロガーを構築するための保護されたメソッド。

フィールド

GlobalLoggerName

GLOBAL_LOGGER_NAMEはグローバルロガーの名前です。

プロパティ

AnonymousLogger	匿名ロガーを作成します。
Class	この `Object`ランタイムクラスを返します。 (継承元 Object)
Filter	このロガーの現在のフィルターを取得します。または、このロガーの出力を制御するフィルターを設定します。
Global	Logger という名前のグローバルロガーオブジェクトを返します。
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
JniPeerMembers	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。
Level	このロガーに指定されているログレベルを取得します。または、このロガーによってログに記録されるメッセージレベルを指定するログレベルを設定します。
Name	このロガーの名前を取得します。
Parent	このロガーの親を返します。または、このロガーの親を設定します。
PeerReference	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
ResourceBundle	このロガーのローカライズリソースバンドルを取得します。または、このロガーにリソースバンドルを設定します。
ResourceBundleName	このロガーのローカライズリソースバンドル名を取得します。
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
UseParentHandlers	このロガーが出力を親ロガーに送信しているかどうかを検出します。または、このロガーが出力を親ロガーに送信するかどうかを指定します。

メソッド

AddHandler(Handler)	ログメッセージを受信するログハンドラーを追加します。
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Config(ISupplier)	CONFIG メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Config(String)	CONFIG メッセージをログに記録します。
Dispose()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
Dispose(Boolean)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
Entering(String, String)	メソッドエントリをログに記録します。
Entering(String, String, Object)	メソッドエントリを 1 つのパラメーターでログに記録します。
Entering(String, String, Object[])	パラメーターの配列を使用して、メソッドエントリをログに記録します。
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
Exiting(String, String)	メソッドの戻り値をログに記録します。
Exiting(String, String, Object)	結果オブジェクトを使用して、メソッドの戻り値をログに記録します。
Fine(ISupplier)	FINE メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Fine(String)	FINE メッセージをログに記録します。
Finer(ISupplier)	FINER メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Finer(String)	FINER メッセージをログに記録します。
Finest(ISupplier)	FINEST メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Finest(String)	FINEST メッセージをログに記録します。
GetAnonymousLogger(String)	匿名ロガーを作成します。
GetHandlers()	このロガーに関連付けられているハンドラーを取得します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetLogger(String)	名前付きサブシステムのロガーを検索または作成します。
GetLogger(String, String)	名前付きサブシステムのロガーを検索または作成します。
Info(ISupplier)	INFO メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Info(String)	INFO メッセージをログに記録します。
IsLoggable(Level)	特定のレベルのメッセージがこのロガーによって実際にログに記録されるかどうかを確認します。
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Log(Level, ISupplier)	メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Log(Level, String)	引数なしでメッセージをログに記録します。
Log(Level, String, Object)	1 つのオブジェクトパラメーターを使用してメッセージをログに記録します。
Log(Level, String, Object[])	オブジェクト引数の配列を含むメッセージをログに記録します。
Log(Level, String, Throwable)	関連するスロー可能な情報を含むメッセージをログに記録します。
Log(Level, Throwable, ISupplier)	スロー可能な情報に関連付けられた、遅延作成されたメッセージをログに記録します。
Log(LogRecord)	LogRecord をログに記録します。
Logp(Level, String, String, ISupplier)	ソースクラスとメソッドを指定して、遅延構築されたメッセージを引数なしでログに記録します。
Logp(Level, String, String, String)	ソースクラスとメソッドを指定して、引数なしでメッセージをログに記録します。
Logp(Level, String, String, String, Object)	1 つのオブジェクトパラメーターを使用して、ソースクラスとメソッドを指定してメッセージをログメッセージに記録します。
Logp(Level, String, String, String, Object[])	ソースクラスとメソッドを指定して、オブジェクト引数の配列を含むメッセージをログに記録します。
Logp(Level, String, String, String, Throwable)	関連する Throwable 情報を使用して、ソースクラスとメソッドを指定してメッセージをログに記録します。
Logp(Level, String, String, Throwable, ISupplier)	スロー可能な情報に関連付けられたソースクラスとメソッドを指定して、遅延作成されたメッセージをログに記録します。
Logrb(Level, String, String, ResourceBundle, String, Object[])	ソースクラス、メソッド、およびリソースバンドル名を引数なしで指定して、メッセージをログに記録します。
Logrb(Level, String, String, ResourceBundle, String, Throwable)	関連する Throwable 情報を使用して、ソースクラス、メソッド、およびリソースバンドルを指定して、メッセージをログに記録します。
Logrb(Level, String, String, String, String)	ソースクラス、メソッド、およびリソースバンドル名を引数なしで指定して、メッセージをログに記録します。
Logrb(Level, String, String, String, String, Object)	1 つのオブジェクトパラメーターを使用して、ソースクラス、メソッド、およびリソースバンドル名を指定して、メッセージをログメッセージに記録します。
Logrb(Level, String, String, String, String, Object[])	ソースクラス、メソッド、およびリソースバンドル名を指定して、オブジェクト引数の配列を含むメッセージをログに記録します。
Logrb(Level, String, String, String, String, Throwable)	関連する Throwable 情報を使用して、ソースクラス、メソッド、およびリソースバンドル名を指定してメッセージをログに記録します。
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
RemoveHandler(Handler)	ログハンドラーを削除します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
Severe(ISupplier)	SEVERE メッセージをログに記録します。これは、メッセージが実際にログに記録されるようにログレベルが設定されている場合にのみ作成されます。
Severe(String)	SEVERE メッセージをログに記録します。
Throwing(String, String, Throwable)	例外をスローするログ。
ToArray<T>()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
ToString()	オブジェクトの文字列表現を返します。 (継承元 Object)
UnregisterFromRuntime()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
Wait()	現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object)
Wait(Int64)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Warning(ISupplier)	警告メッセージをログに記録します。これは、ログ記録レベルがメッセージが実際にログに記録されるようにする場合にのみ作成されます。
Warning(String)	警告メッセージを記録します。

明示的なインターフェイスの実装

IJavaPeerable.Disposed()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.Finalized()	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。 (継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。
GetJniTypeName(IJavaPeerable)	Logger オブジェクトは、特定のシステムまたはアプリケーションコンポーネントのメッセージをログに記録するために使用されます。

適用対象

次の方法で共有