パッケージ java.util.logging

Java^TM 2 プラットフォームのコアロギング機能のクラスとインタフェースを提供します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
Filter	Filter は、ログレベルが提供する制御以上に、ログ対象をきめ細かく制御するために使用されます。
LoggingMXBean	ロギング機能の管理インタフェースです。

クラスのサマリー

クラス	説明
ConsoleHandler	この Handler は、ログレコードを System.err に発行します。
ErrorManager	ErrorManager オブジェクトは Handler に接続され、ロギング時に Handler で発生するエラーを処理します。
FileHandler	単純ファイルのロギング Handler です。
Formatter	Formatter は LogRecord のフォーマット処理をサポートします。
Handler	Handler オブジェクトは、Logger からログメッセージを受け取り、それらをエクスポートします。
Level	Level クラスは、ロギング出力の制御に使用可能な一連の標準ロギングレベルを定義します。
Logger	Logger オブジェクトは、特定のシステムコンポーネントやアプリケーションコンポーネントのメッセージをロギングするために使用されます。
LoggingPermission	SecurityManager によって実行されるコードが Logger.setLevel などのログ制御メソッドのいずれかを呼び出すときに、SecurityManager がチェックするアクセス権です。
LogManager	Logger とログサービスの共有状態のセットを管理するために使用される単一のグローバル LogManager オブジェクトがあります。
LogRecord	LogRecord オブジェクトを使用して、ログのフレームワークと個々のログ Handler 間のロギングの要求を渡します。
MemoryHandler	メモリーの循環バッファーの要求をバッファー処理する Handler です。
SimpleFormatter	LogRecord の簡単なサマリーを人が理解できる形式で出力します。
SocketHandler	簡潔なネットワークログ Handler です。
StreamHandler	ストリームに基づくログ Handler です。
XMLFormatter	LogRecord を標準 XML 形式でフォーマットします。

パッケージ java.util.logging の説明

Java^TM 2 プラットフォームのコアロギング機能のクラスとインタフェースを提供します。ロギング API の主な目的は、顧客サイトでのソフトウェアの管理とサービスをサポートすることです。

ログを使用する主な 4 つの目的は次のとおりです。

1. エンドユーザーとシステム管理者による問題の診断。これは、リソースの不足、セキュリティー障害、および単純な設定エラーなど、ローカルで修復または追跡可能なよくある問題の簡潔なロギングから構成されます。
2. フィールドサービスエンジニアによる問題の診断。フィールドサービスエンジニアが使用するロギング情報は、システム管理者が必要とする情報よりも大幅に複雑かつ冗長なものとなる可能性があります。通常、そのような情報を取得するには、特定サブシステム内での追加ロギングが必要となります。
3. 開発組織による問題の診断。フィールドで問題が発生した場合、場合によっては取得したロギング情報を元の開発チームに診断用として戻す必要があります。このロギング情報は、極めて詳細でかなり難解なものになる可能性があります。場合によってはこのような情報には特定のサブシステムの内部実行の詳細なトレースが含まれます。
4. 開発者による問題の診断。ロギング API は、開発中のアプリケーションのデバッグを支援する目的でも使用できます。これにはおそらく、ターゲットアプリケーションによって生成されるロギング情報や低レベルライブラリによって生成されるロギング情報が含まれます。ただし、この使用方法はまったく妥当なものですが、ロギング API の目的は、開発環境内にすでに存在している可能性のある、通常のデバッグツールやプロファイリングツールに取って代わることではありません。

このパッケージの主な要素は次のとおりです。

• Logger: アプリケーションがロギング呼び出しを行う際に使用する主要エンティティーです。Logger オブジェクトは、特定のシステムコンポーネントやアプリケーションコンポーネントのメッセージをロギングするために使用されます。
• LogRecord: これを使用して、ログフレームワークと個々のログハンドラとの間のロギング要求を渡します。
• ハンドラ: メモリー、出力ストリーム、コンソール、ファイル、ソケットなど、さまざまな出力先に LogRecord オブジェクトをエクスポートします。この目的のために、さまざまな Handler サブクラスが存在しています。追加の Handler が Sun 以外で開発され、コアプラットフォームに加えて提供される場合があります。
• Level: ログ出力を制御するために使用される標準ログレベルのセットを定義します。プログラムはほかのレベルでの出力を無視して一部のレベルのログを出力するよう構成できます。
• Filter: ログレベルが提供する制御を超えた、ログデータに対するきめ細かい制御を行います。ロギング API がサポートする汎用フィルタメカニズムを使えば、アプリケーションコードは、任意のフィルタを接続してロギングの出力を制御できます。
• Formatter: LogRecord オブジェクトのフォーマット処理のサポートを提供します。このパッケージには SimpleFormatter、XMLFormatter の 2 つのフォーマッタが含まれています。これらはそれぞれ、ログレコードをプレーンテキスト、XML でフォーマットするためのものです。Handler と同様に、追加の Formatter が Sun 以外で開発される場合があります。

ロギング API は、静的構成制御、動的構成制御の両方を提供します。静的制御を使えば、フィールドサービススタッフは、特定の構成を設定したあと、その新しいロギング設定を使ってアプリケーションを再起動することができます。動的制御を使えば、現在実行中のプログラム内からロギング構成を更新できます。また、この API では、システムの機能領域ごとにロギングの有効/無効を切り替えることもできます。たとえば、あるフィールドサービスエンジニアは、すべての AWT イベントを追跡することには関心があっても、ソケットイベントやメモリー管理にはまったく関心がない場合があるからです。

null ポインタ

一般に、javadoc 内で特に記載のないかぎり、メソッドおよびコンストラクタは、null 引数を渡されると NullPointerException をスローします。この規則には大きな例外が 1 つあります。それは、Logger クラスのロギング簡易メソッド (config、entering、exiting、fine、finer、finest、log、logp、logrb、severe、throwing、および warning メソッド) は、最初の Level 引数 (存在する場合) を除くすべての引数で null 値を受け取る、ということです。

関連項目

制御フローの概要については、「Java ロギングの概要」を参照してください。

導入されたバージョン:

1.4