JavaTM Platform
Standard Ed. 6

パッケージ java.util.logging

JavaTM 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 の説明

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

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

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

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

ロギング 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。