- すべての実装されたインタフェース:
Serializable
通常、クライアントはLevel.SEVEREなど定義済みのLevel定数を使用する必要があります。
次に、レベルを降順で示します。
- SEVERE(最高値)
- WARNING
- INFO
- CONFIG
- FINE
- FINER
- FINEST(最低値)
サード・パーティが、Levelのサブクラスを作成することで追加のロギング・レベルを定義することも可能です。 そうした場合、サブクラス作成時に、一意の整数レベル値を選択することと、適切なreadResolveメソッドを定義することで直列化を通してObjectが一意のプロパティを保持できるように注意する必要があります。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
フィールドのサマリー
修飾子と型フィールド説明static final Level
ALLはすべてのメッセージのログをとることを示します。static final Level
CONFIGは静的な構成メッセージのメッセージ・レベルです。static final Level
FINEはトレース情報を提供するメッセージ・レベルです。static final Level
FINERはかなり詳細なトレース・メッセージを示します。static final Level
FINESTは非常に詳細なトレース・メッセージを示します。static final Level
INFOはメッセージを情報として提供するメッセージ・レベルです。static final Level
OFFはロギングをオフするために使われる特殊なレベルです。static final Level
SEVEREは重大な障害を示すメッセージ・レベルです。static final Level
WARNINGは潜在的な問題を示すメッセージ・レベルです。 -
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明boolean
2つのオブジェクトの値が等しいかどうかを比較します。現在のデフォルト・ロケールに対して、Levelのローカライズされた文字列名を返します。getName()
Levelのローカライズされていない文字列名を返します。レベルのローカリゼーション・リソース・バンドル名、またはローカリゼーション・バンドルが定義されていない場合はnullを返します。int
hashCode()
ハッシュ・コードを生成します。final int
intValue()
このレベルの整数値を取得します。static Level
レベル名の文字列をLevelに構文解析します。final String
toString()
このLevelの文字列表現を返します。
-
フィールド詳細
-
OFF
public static final Level OFFOFFはロギングをオフするために使われる特殊なレベルです。 このレベルはInteger.MAX_VALUE
に初期化されます。 -
SEVERE
public static final Level SEVERESEVEREは重大な障害を示すメッセージ・レベルです。一般に、SEVEREメッセージは、通常のプログラム実行の妨げになるような、非常に重要なイベントを記述すべきです。 それらは、エンド・ユーザーとシステム管理者にとって適度に理解しやすいものであるべきです。 このレベルは
1000
に初期化されます。 -
WARNING
public static final Level WARNINGWARNINGは潜在的な問題を示すメッセージ・レベルです。一般的にWARNINGメッセージでは、エンド・ユーザーまたはシステム管理者が関心を持つ、または潜在的な問題を示すイベントを説明します。 このレベルは
900
に初期化されます。 -
INFO
public static final Level INFOINFOはメッセージを情報として提供するメッセージ・レベルです。INFOメッセージは通常、コンソールまたはそれと同等のものに書き込まれます。 このため、INFOレベルは、エンド・ユーザーとシステム管理者が理解できるかなり重要なメッセージにのみ使用しなければいけません。 このレベルは
800
に初期化されます。 -
CONFIG
public static final Level CONFIGCONFIGは静的な構成メッセージのメッセージ・レベルです。CONFIGメッセージの目的は、さまざまな静的構成情報を提供することで、特定の構成に関係する可能性のある問題のデバッグを支援することです。 たとえば、CONFIGメッセージにはCPUのタイプ、グラフィックスの深さ、GUIのLook & Feelなどを含めることができます。このレベルは
700
に初期化されます。 -
FINE
public static final Level FINEFINEはトレース情報を提供するメッセージ・レベルです。FINE、FINER、FINESTはどれも、比較的詳細な追跡を行うためのものです。 この3つのレベルの正確な意味はサブシステムごとに異なりますが、一般に、FINESTはもっとも大量で詳しい出力に対して、FINERはそれよりも若干詳細度の劣る出力に対して、FINEはもっとも量の少ない(したがってもっとも重要度の高い)メッセージに対して、それぞれ使用されます。
一般的に、FINEレベルは、特定のサブシステムに特別な関心を持たない開発者にとって広く興味のある情報のために使用されます。
FINEメッセージは復旧可能な小さな障害などのメッセージを含む場合があります。 潜在的なパフォーマンス劣化を示す問題も、FINEとしてロギングする価値があります。 このレベルは
500
に初期化されます。 -
FINER
public static final Level FINERFINERはかなり詳細なトレース・メッセージを示します。 デフォルトで、例外の入力、戻り、スローなどのログ呼出しはこのレベルでトレースされます。 このレベルは400
に初期化されます。 -
FINEST
public static final Level FINESTFINESTは非常に詳細なトレース・メッセージを示します。 このレベルは300
に初期化されます。 -
ALL
public static final Level ALLALLはすべてのメッセージのログをとることを示します。 このレベルはInteger.MIN_VALUE
に初期化されます。
-
-
コンストラクタの詳細
-
Level
protected Level(String name, int value) 指定された整数値で名前付きLevelを作成します。このコンストラクタはサブクラス化できるように「protect」になっています。 一般に、ロギングのクライアントは、SEVEREやFINESTなど、定数のLevelオブジェクトのいずれかを使用する必要があります。 ただし、クライアントで新しいロギング・レベルを追加する必要がある場合には、Levelのサブクラスを作成し、新しい定数を定義することができます。
- パラメータ:
name
- Levelの名前。たとえば「SEVERE」。value
- レベルの整数値。- 例外:
NullPointerException
- 名前がnullである場合
-
Level
指定された整数値と指定されたローカリゼーション・リソース名で名前付きLevelを作成します。- パラメータ:
name
- Levelの名前。たとえば「SEVERE」。value
- レベルの整数値。resourceBundleName
- 指定された名前のローカライズに使用するリソース・バンドルの名前。 resourceBundleNameがnullまたは空文字列の場合、これは無視される- 例外:
NullPointerException
- 名前がnullである場合
-
-
メソッドの詳細
-
getResourceBundleName
public String getResourceBundleName()レベルのローカリゼーション・リソース・バンドル名、またはローカリゼーション・バンドルが定義されていない場合はnullを返します。- 戻り値:
- ローカリゼーションのリソース・バンドル名
-
getName
public String getName()Levelのローカライズされていない文字列名を返します。- 戻り値:
- ローカライズされていない名前
-
getLocalizedName
public String getLocalizedName()現在のデフォルト・ロケールに対して、Levelのローカライズされた文字列名を返します。ローカリゼーション情報が使用できない場合、ローカライズされていない名前が返されます。
- 戻り値:
- ローカライズされた名前
-
toString
public final String toString()このLevelの文字列表現を返します。 -
intValue
public final int intValue()このレベルの整数値を取得します。 この整数値を使えば、Levelオブジェクト間の順序付け比較を効率的に行えます。- 戻り値:
- このレベルの整数値。
-
parse
public static Level parse(String name) throws IllegalArgumentException レベル名の文字列をLevelに構文解析します。引数文字列はレベル名または整数値のいずれかで構成されます。
たとえば:
- "SEVERE"
- "1000"
- パラメータ:
name
- 解析される文字列- 戻り値:
- 構文解析される値 既知の名前に対応する整数(700など)を渡すと、その関連する名前(
CONFIG
など)が返されます。 そうでない整数(1など)を渡した場合、その値に初期化された新しいレベル名が返される。 - 例外:
NullPointerException
- 名前がnullである場合IllegalArgumentException
- 値が有効でない場合。 有効な値は、Integer.MIN_VALUE
からInteger.MAX_VALUE
までの整数と、すべての既知のレベル名である。 既知の名前とは、このクラスで定義されているレベル(つまり、FINE
、FINER
、FINEST
)、適切なパッケージ・アクセスを使ってこのクラスによって作成されたレベル、またはサブクラスによって定義または作成された新しいレベルのことである。
-
equals
public boolean equals(Object ox) 2つのオブジェクトの値が等しいかどうかを比較します。 -
hashCode
public int hashCode()ハッシュ・コードを生成します。
-