クラスLogger
Loggerオブジェクトを取得するには、getLoggerファクトリ・メソッドのいずれかを呼び出します。 これらは、新しいLoggerを作成するか、既存の適したLoggerを返します。 getLoggerファクトリ・メソッドのいずれかによって返されるLoggerは、Loggerに対する強い参照が保持されなければ、いつでもガベージ・コレクトされる可能性があると理解することが重要です。
ログ・メッセージは登録されたHandlerオブジェクトに転送されます。このオブジェクトは、コンソール、ファイル、OSログなどさまざまな出力先にメッセージを転送できます。
各Loggerは、Loggerの名前空間にある既存の上位クラスにもっとも近い「親」Loggerを追跡します。
各Loggerには「Level」が関連付けられます。 これは、このロガーの処理対象となる最小のLevelを表します。 ロガーのレベルがnullに設定されている 合、その有効レベルはその親から継承され、親から再帰的に取得される可能性があり、ツリーの上位まで続きます。
ログ・レベルは、LogManagerクラスで説明しているように、ロギング構成ファイルのプロパティに基づいて構成できます。 た しそれは、Logger.setLevelメソッドを呼び出して動的に変更することもできます。 ロガーのレベルが変更されると、そのレベルとしてnullを持つ子ロガーは親からその有効レベルを継承するため、変更も子ロガーに影響する可能性があります。
ロギング呼出しが行われるたびに、Loggerはまず、そのロガーの実効ログ・レベルに基づく要求レベル(SEVEREやFINEなど)の低コストなチェックを実行します。 要求レベルがログ・レベルよりも低い 合、ロギング呼出しはすぐに復帰します。
この初期テスト(低コストのテスト)にパスすると、Loggerは、LogRecordを割り当ててロギング・メッセージを記述します。 次に、それは、Filterが存在する 合にはそれを呼び出し、そのレコードを発行すべきかどうかについて、より詳しいチェックを行います。 それにパスした 合、それは、そのLogRecordを自身の出力Handlerに発行します。 デフォルトでは、ロガーは親のHandlerにも発行します。これが、ツリーの上方に向けて再帰的に繰り返されます。
各Loggerには、関連付けられたResourceBundleがある 合があります。 ResourceBundleは、getLogger(java.lang.String, java.lang.String)ファクトリ・メソッドを使用して名前で指定するか、またはsetResourceBundleメソッドを使用して値で指定できます。 このバンドルはロギング・メッセージをローカライズするために使用されます。 Loggerが独自のResourceBundleまたはリソース・バンドル名を持たない 合、ResourceBundleまたはリソース・バンドル名を親から継承し、ツリーの上方に向けて再帰的に繰り返されます。
ロガーの出力メソッドのほとんどは、「msg」引数を取ります。 このmsg引数には、生の値、ローカリゼーション・キーのいずれかを指定できます。 書式設定時に、ロガーがローカリゼーションResourceBundleを持って(または継承して)おり、そのResourceBundleにメッセージ文字列のマッピングがある 合、メッセージ文字列はローカライズされた値に置き換えられます。 それ以外の 合は、元のmsg文字列が使用されます。 フォーマッタは通常、java.text.MessageFormatスタイルのフォーマットを使ってパラメータを書式設定するため、たとえば、フォーマット文字列「{0} {1}」は、2つのパラメータを文字列として書式設定します。
一連のメソッドは、「msg」引数の代わりに「msgSupplier」をとります。 これらのメソッドは、Supplier<String>関数をとり、この関数はメッセージが実際に実効ログ・レベルに基づいて、ログに記録されるときにのみ、目的のログ・メッセージを構築するために呼び出されるため、不要なメッセージの構築がなくなります。 たとえば、開発者が、文字列を受け付けるバージョンで、診断用のシステ 正常性ステータスをログに記録したい 合、コードは次のようなものになります。
class DiagnosisMessages {
static String systemHealthStatus() {
// collect system health information
...
}
}
...
logger.log(Level.FINER, DiagnosisMessages.systemHealthStatus());
logger.log(Level.FINER, DiagnosisMessages::systemHealthStatus);
ロガーがResourceBundleを検索する 合、まずバンドルがsetResourceBundleを使用して指定されているかどうか、次に、getLoggerファクトリ・メソッドによって、リソースバンドル名が指定されているかどうかのみを調べます。 ResourceBundleまたはリソース・バンドル名が見つからない 合は、親ツリーから継承したもっとも近いResourceBundleまたはリソース・バンドル名を使用します。 ResourceBundleが継承されているか、setResourceBundleメソッドによって指定されている 合、そのResourceBundleが使われます。 そうでない 合に、ロガーがリソース・バンドル名のみを持つか、継承している 合は、ロギング時に、デフォルトのロケールを使用して、そのリソース・バンドル名をResourceBundleオブジェクトにマッピングします。
リソース・バンドル名をResourceBundleオブジェクトにマッピングする際に、ロガーはまずスレッドのコンテキスト・クラス・ローダーを使用して、指定されたリソース・バンドル名をResourceBundleにマッピングします。 スレッド・コンテキスト・クラス・ローダーがnullの 合、代わりにシステ ・クラス・ローダーを試します。 ResourceBundleがま 見つからない 合、getLoggerファクトリ・メソッドの最初の呼出し元のクラス・ローダーを使用します。
ローカリゼーションを含むフォーマット処理は、通常Formatterを呼び出す出力Handlerを担当します。
フォーマット処理は同期的に行う必要がないことに注意してく さい。 それは、LogRecordが外部シンクに実際に書き込まれるまで遅延できます。
ロギング・メソッドは、次の5つの主なカテゴリに分類されます。
ログ・レベル、メッセージ文字列、およびそのメッセージ文字列への任意のパラメータを取得するlogメソッドのセット
logメソッドに類似するが、明示的なソース・クラス名とメソッド名も取得するlogpメソッドのセット(logpは「log precise」の略)
logpメソッドに類似するが、ログ・メッセージのローカライズに使用するための明示的なリソース・バンドル・オブジェクトもとるlogrbメソッドのセット(logrbは「log with resource bundle」の略)があります。
メソッドのエントリ(enteringメソッド)、メソッドの復帰(exitingメソッド)、および例外のスロー(throwingメソッド)を追跡するための簡易メソッド
最後に、開発者がた 単純な文字列を特定のログ・レベルでロギングする、といった非常に単純な 合に使用するための、一連の簡易メソッドが存在する。 これらのメソッドは、「severe」、「warning」、「info」など、標準のLevel名にちなん 名前を持ち、メッセージ文字列を単一の引数として取る。
明示的なソース名とメソッド名を取らないメソッドの 合、Loggingフレー ワークは「最善の努力」を払って、どのクラスとメソッドがそのロギング・メソッドを呼び出したのかを判定します。 た し、自動的に推測されたこの情 は概略に過ぎない(それどころか完全な間違いである可能性さえある)ことを理解しておく必要があります。 仮想マシンは、JIT処理の際に大規模な最適化を行うことが許されており、スタック・フレー をすべて削除する可能性があるため、呼出しクラスとメソッドを確実に検出することは不可能となっています。
Loggerのすべてのメソッドは、マルチスレッド・セーフです。
サブクラス化に関する情 : LogManagerクラスが名前付きLoggerの独自実装を名前空間内の任意の位置に提供する可能性があることに注意してく さい。 したがって、Loggerのすべてのサブクラスは、(それらが別の新しいLogManagerクラスとともに実装されたのでないかぎり)、忘れずにLogManagerクラスからLoggerインスタンスを取得し、そのインスタンスに「isLoggable」や「log(LogRecord)」などのオペレーションを委譲すべきです。 すべてのロギング出力を横取りするためにサブクラスが行う必要があるのは、log(LogRecord)メソッドのオーバーライド けであることに注意してく さい。 ほかのロギング・メソッドはすべて、このlog(LogRecord)メソッドへの呼び出しとして実装されています。
- 導入されたバージョン:
- 1.4
-
フィールドのサマリー
フィールド -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明voidaddHandler(Handler handler) ログHandlerを追 してログ・メッセージを受け取ります。voidCONFIGメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、CONFIGメッセージのログを記録します。voidメソッド・エントリのログをとります。void1つのパラメータを持つメソッド・エントリのログをとります。voidパラメータの配列を持つメソッド・エントリのログをとります。voidメソッド復帰のログをとります。void結果オブジェクトを持つメソッド復帰のログをとります。voidFINEメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、FINEメッセージのログを記録します。voidFINERメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、FINERメッセージのログを記録します。voidFINESTメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、FINESTメッセージのログを記録します。static Logger匿名Loggerを作成します。static LoggergetAnonymousLogger(String resourceBundleName) 匿名Loggerを作成します。このLoggerの現在のフィルタを返します。static final LoggerLogger.GLOBAL_LOGGER_NAMEという名前でグローバル・ロガー・オブジェクトを返します。Handler[]このロガーに関連したHandlerを返します。getLevel()このLoggerに指定されたログLevelを取得します。static Logger指定されたサブシステ のロガーを検出または作成します。static Logger指定されたサブシステ のロガーを検出または作成します。getName()このロガーの名前を返します。このロガーの親を返します。このロガーのローカリゼーション・リソース・バンドルを取得します。このロガーのローカリゼーション・リソース・バンドルの名前を取得します。booleanこのロガーが出力をその親ロガーに送信しているかどうかを検出します。voidINFOメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、INFOメッセージのログを記録します。booleanisLoggable(Level level) 指定されたレベルのメッセージがこのロガーによって実際にロギングされるかどうかをチェックします。void引数のないメッセージのログをとります。void1つのオブジェクトのパラメータを持つメッセージのログをとります。voidオブジェクトの引数の配列を持つメッセージのログをとります。void関連するThrowable情 を持つメッセージのログをとります。void関連するThrowable情 を含む、遅延構築されたメッセージのログを記録します。voidメッセージが実際に記録されるロギング・レベルである 合にのみ構築される、メッセージのログを記録します。voidLogRecordのログをとります。voidソース・クラスとメソッドを指定する、引数のないメッセージのログをとります。voidソース・クラスとメソッドを指定し、ログ・メッセージに対して単一のオブジェクト・パラメータを持つメッセージのログをとります。voidソース・クラスとメソッドを指定する、オブジェクトの引数の配列を持つメッセージのログをとります。voidソース・クラスとメソッドを指定し、関連するThrowable情 を持つメッセージのログをとります。voidlogp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier) ソース・クラスとメソッドを指定し、関連するThrowable情 を含む遅延構築されたメッセージのログを記録します。voidソース・クラスとメソッドを指定する、引数のない遅延構築されたメッセージのログを記録します。voidvoidlogrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1) voidlogrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params) voidlogrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown) voidlogrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params) ソース・クラス、メソッド、およびリソース・バンドルを指定し、メッセージ・パラメータのオプションのリストを含むメッセージのログを記録します。voidlogrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown) ソース・クラス、メソッド、およびリソース・バンドルを指定し、関連するThrowable情 を含むメッセージのログを記録します。voidlogrb(Level level, ResourceBundle bundle, String msg, Object... params) ソース・クラス、メソッド、およびリソース・バンドルを指定し、メッセージ・パラメータのオプションのリストを含むメッセージのログを記録します。voidlogrb(Level level, ResourceBundle bundle, String msg, Throwable thrown) ソース・クラス、メソッド、およびリソース・バンドルを指定し、関連するThrowable情 を含むメッセージのログを記録します。voidremoveHandler(Handler handler) ログHandlerを削除します。voidフィルタを設定してこのLoggerの出力を制御します。voidこのロガーがどのメッセージ・レベルをロギングするかを指定するログ・レベルを設定します。voidこのロガーの親を設定します。voidsetResourceBundle(ResourceBundle bundle) このロガーのリソース・バンドルを設定します。voidsetUseParentHandlers(boolean useParentHandlers) このロガーが出力をその親ロガーに送信すべきかどうかを指定します。voidSEVEREメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、SEVEREメッセージのログを記録します。void例外をスローするログをとります。voidWARNINGメッセージのログをとります。voidメッセージが実際にログに記録されるロギング・レベルである 合にのみ構築される、WARNINGメッセージのログを記録します。
-
フィールド詳細
-
GLOBAL_LOGGER_NAME
public static final String GLOBAL_LOGGER_NAMEGLOBAL_LOGGER_NAMEは、グローバル・ロガーの名前です。- 導入されたバージョン:
- 1.6
- 関連 目:
-
global
@Deprecated public static final Logger global非推奨。このフィールドを初期化すると、デッドロックが発生しやすくなります。 このフィールドはLoggerクラス初期化によって初期化されますが、それにより、LogManagerクラス初期化との間でデッドロックが発生する可能性があります。 そのような 合、2つのクラス初期化は他方が完了するまで待機します。 グローバル・ロガー・オブジェクトを取得するための推奨の方法は、Logger.getGlobal()を呼び出すことです。Logger.getGlobal()を使用できない古いJDKバージョンとの互換性のため、Logger.getLogger(Logger.GLOBAL_LOGGER_NAME)またはLogger.getLogger("global")の呼出しを使用してく さい。「global」Loggerオブジェクトは、ロギング・パッケージを時々使用する開発者の便宜を図るために提供されています。 製品などでロギング・パッケージを本 的に使用する開発者は、適切な名前を持つ独自のLoggerオブジェクトを作成し、それを使用すべきです。そうすれば、適切なLogger単位の粒度でロギングを制御することができます。 また、開発者は、Loggerオブジェクトがガベージ・コレクトされないようにするため、Loggerオブジェクトへの強い参照を保持しておく必要があります。
-
-
コンストラクタの詳細
-
Logger
名前付きサブシステ のロガーを構築するprotectedメソッドです。当初、ロガーはLevelがnull、useParentHandlersがtrueで構成されます。
- パラメータ:
name- ロガーの名前。 これはドットで区切られた名前にすべきであり、通常はjava.netやjavax.swingなど、サブシステ のパッケージ名またはクラス名に基づいた名前にすべきである。 匿名Loggerの 合はnullも可能resourceBundleName- このロガーのメッセージのローカライズに使用されるResourceBundleの名前。 ローカリゼーションを必要とするメッセージが存在しない 合はnullも可能- スロー:
MissingResourceException- resourceBundleNameがnull以外であり、それに対応するリソースが見つからない 合。
-
-
メソッドの詳細
-
getGlobal
public static final Logger getGlobal()Logger.GLOBAL_LOGGER_NAMEという名前でグローバル・ロガー・オブジェクトを返します。- 戻り値:
- グローバル・ロガー・オブジェクト
- 導入されたバージョン:
- 1.7
-
getLogger
指定されたサブシステ のロガーを検出または作成します。 指定された名前のロガーがすでに作成されていた 合はそれが返されます。 それ以外の 合は新しいロガーが作成されます。新しいロガーが作成された 合、そのログ・レベルはLogManager構成に基づいて構成され、そのログ出力もその親のハンドラに送信するように構成されます。 これはLogManagerのグローバル名前空間に登録されます。
ノート: LogManagerは新しく作成されたロガーへの弱参照しか保持できません。 指定した名前で以前に作成されたロガーは、ロガーへの強い参照がない 合に、いつでもガベージ・コレクトされる可能性があることを理解することが重要です。 特に、このことは、
getLogger("MyLogger").log(...)などの2つの連続した呼出しで、プログラ のどこにも「MyLogger」という名前のロガーへの強い参照がない 合、「MyLogger」という名前の別のロガー・オブジェクトが使われる可能性があることを意味します。- パラメータ:
name- ロガーの名前。 これはドットで区切られた名前にすべきであり、通常はjava.netやjavax.swingなど、サブシステ のパッケージ名またはクラス名に基づいた名前にすべきである- 戻り値:
- 適切なLogger
- スロー:
NullPointerException- 名前がnullの 合。
-
getLogger
指定されたサブシステ のロガーを検出または作成します。 指定された名前のロガーがすでに作成されていた 合はそれが返されます。 それ以外の 合は新しいロガーが作成されます。新しいロガーが作成された 合、そのログ・レベルはLogManagerに基づいて構成され、そのログ出力もその親のハンドラに送信するように構成されます。 これはLogManagerのグローバル名前空間に登録されます。
ノート: LogManagerは新しく作成されたロガーへの弱参照しか保持できません。 指定した名前で以前に作成されたロガーは、ロガーへの強い参照がない 合に、いつでもガベージ・コレクトされる可能性があることを理解することが重要です。 特に、このことは、
getLogger("MyLogger", ...).log(...)などの2つの連続した呼出しで、プログラ のどこにも「MyLogger」という名前のロガーへの強い参照がない 合、「MyLogger」という名前の別のロガー・オブジェクトが使われる可能性があることを意味します。指定されたLoggerがすでに存在しており、それがローカリゼーション・リソース・バンドルをま 持っていない 合は、指定されたリソース・バンドル名が使用されます。 指定されたLoggerがすでに存在しており、それが異なるリソース・バンドル名を持っている 合は、IllegalArgumentExceptionがスローされます。
- パラメータ:
name- ロガーの名前。 これはドットで区切られた名前にすべきであり、通常はjava.netやjavax.swingなど、サブシステ のパッケージ名またはクラス名に基づいた名前にすべきであるresourceBundleName- このロガーのメッセージのローカライズに使用されるResourceBundleの名前。 ローカリゼーションを必要とするメッセージが存在しない 合はnullも可能。- 戻り値:
- 適切なLogger
- スロー:
MissingResourceException- resourceBundleNameがnull以外であり、それに対応するリソースが見つからない 合。IllegalArgumentException- Loggerがすでに存在しており、異なるリソース・バンドル名を使用している 合。または、resourceBundleNameがnullが、名前付きロガーにリソース・バンドルが設定されている 合。NullPointerException- 名前がnullの 合。
-
getAnonymousLogger
public static Logger getAnonymousLogger()匿名Loggerを作成します。 新しく作成されたLoggerは、LogManagerの名前空間に登録されません。このファクトリ・メソッドは、主にアプレットからの使用を目的としています。 結果として得られるLoggerは匿名であるため、作成元のクラスによって非公開の状態に保たれます。 これにより、通常のセキュリティ・チェックが不要になり、信 できないアプレット・コードでロガーの制御状態を更新できるようになりました。 たとえば、アプレットは匿名ロガーでsetLevelまたはaddHandlerを実行できます。
新しいロガーは、匿名ではありますが、ルート・ロガー("")を親に持つように構成されます。 これは、そのロガーがデフォルトで、実効レベルとハンドラをルート・ロガーから継承することを意味します。
- 戻り値:
- 新しく作成されたprivate Logger
-
getAnonymousLogger
匿名Loggerを作成します。 新しく作成されたLoggerは、LogManagerの名前空間に登録されません。このファクトリ・メソッドは、主にアプレットからの使用を目的としています。 結果として得られるLoggerは匿名であるため、作成元のクラスによって非公開の状態に保たれます。 これにより、通常のセキュリティ・チェックが不要になり、信 できないアプレット・コードでロガーの制御状態を更新できるようになりました。 たとえば、アプレットは匿名ロガーでsetLevelまたはaddHandlerを実行できます。
新しいロガーは、匿名ではありますが、ルート・ロガー("")を親に持つように構成されます。 これは、そのロガーがデフォルトで、実効レベルとハンドラをルート・ロガーから継承することを意味します。
- パラメータ:
resourceBundleName- このロガーのメッセージのローカライズに使用されるResourceBundleの名前。 ローカリゼーションを必要とするメッセージが存在しない 合はnullも可能- 戻り値:
- 新しく作成されたprivate Logger
- スロー:
MissingResourceException- resourceBundleNameがnull以外であり、それに対応するリソースが見つからない 合。
-
getResourceBundle
public ResourceBundle getResourceBundle()このロガーのローカリゼーション・リソース・バンドルを取得します。 このメソッドは、setResourceBundleメソッドによって設定されたか、現在のデフォルトのロケールでgetLoggerファクトリ・メソッドによって設定されたリソース・バンドル名からマッピングされたResourceBundleを返します。
結果がnullの 合、Loggerは親から継承したリソース・バンドルまたはリソース・バンドル名を使用することに注意してく さい。- 戻り値:
- ローカリゼーション・バンドル(
nullの 合がある)
-
getResourceBundleName
public String getResourceBundleName()このロガーのローカリゼーション・リソース・バンドルの名前を取得します。 これは、getLoggerファクトリ・メソッドによって指定された名前か、またはsetResourceBundleメソッドによって設定されたResourceBundleの基底名のいずれかです。
結果がnullの 合、Loggerは親から継承したリソース・バンドルまたはリソース・バンドル名を使用することに注意してく さい。- 戻り値:
- ローカリゼーション・バンドルの名前(
nullの 合がある)
-
setFilter
public void setFilter(Filter newFilter) フィルタを設定してこのLoggerの出力を制御します。初期の「レベル」検査に合 すると、LoggerはこのFilterを呼び出してログ・レコードが実際に通知されるかどうかを調べます。
- パラメータ:
newFilter- フィルタ・オブジェクト(nullの 合がある)
-
getFilter
-
log
public void log(LogRecord record) LogRecordのログをとります。このクラス内のその他のロギング・メソッドはすべて、このメソッドを呼び出すことで、実際のあらゆるロギングを実行します。 サブクラスは、このメソッドをオーバーライドする けで、すべてのログ活動を捕捉できます。
- パラメータ:
record- 通知されるLogRecord
-
log
-
log
メッセージが実際に記録されるロギング・レベルである 合にのみ構築される、メッセージのログを記録します。指定されたメッセージ・レベルでロガーが現在使用可能な 合、メッセージが指定されたサプライヤ関数を呼び出して構築され、登録されているすべての出力ハンドラ・オブジェクトに転送されます。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREmsgSupplier- 呼び出されると、目的のログ・メッセージを生成する関数- 導入されたバージョン:
- 1.8
-
log
-
log
-
log
関連するThrowable情 を持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定された引数が、登録されたすべての出力ハンドラに転送されたLogRecordに 納されます。
thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREmsg- 文字列メッセージ、またはメッセージ・カタログのキーthrown- ログ・メッセージに関連したThrowable。
-
log
関連するThrowable情 を含む、遅延構築されたメッセージのログを記録します。指定されたメッセージ・レベルでロガーが現在使用可能な 合、メッセージが指定されたサプライヤ関数を呼び出して構築されます。 次に、メッセージと指定された
ThrowableがLogRecordに 納され、これが登録されているすべての出力ハンドラに転送されます。thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREthrown- ログ・メッセージに関連したThrowable。msgSupplier- 呼び出されると、目的のログ・メッセージを生成する関数- 導入されたバージョン:
- 1.8
-
logp
ソース・クラスとメソッドを指定する、引数のないメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
logp
public void logp(Level level, String sourceClass, String sourceMethod, Supplier<String> msgSupplier) ソース・クラスとメソッドを指定する、引数のない遅延構築されたメッセージのログを記録します。指定されたメッセージ・レベルでロガーが現在使用可能な 合、メッセージが指定されたサプライヤ関数を呼び出して構築され、登録されているすべての出力ハンドラ・オブジェクトに転送されます。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名msgSupplier- 呼び出されると、目的のログ・メッセージを生成する関数- 導入されたバージョン:
- 1.8
-
logp
ソース・クラスとメソッドを指定し、ログ・メッセージに対して単一のオブジェクト・パラメータを持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、対応するLogRecordが作成され、登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名msg- 文字列メッセージ、またはメッセージ・カタログのキーparam1- ログ・メッセージのパラメータ。
-
logp
ソース・クラスとメソッドを指定する、オブジェクトの引数の配列を持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、対応するLogRecordが作成され、登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名msg- 文字列メッセージ、またはメッセージ・カタログのキーparams- メッセージのパラメータの配列
-
logp
public void logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown) ソース・クラスとメソッドを指定し、関連するThrowable情 を持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定された引数が、登録されたすべての出力ハンドラに転送されたLogRecordに 納されます。
thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名msg- 文字列メッセージ、またはメッセージ・カタログのキーthrown- ログ・メッセージに関連したThrowable。
-
logp
public void logp(Level level, String sourceClass, String sourceMethod, Throwable thrown, Supplier<String> msgSupplier) ソース・クラスとメソッドを指定し、関連するThrowable情 を含む遅延構築されたメッセージのログを記録します。指定されたメッセージ・レベルでロガーが現在使用可能な 合、メッセージが指定されたサプライヤ関数を呼び出して構築されます。 次に、メッセージと指定された
ThrowableがLogRecordに 納され、これが登録されているすべての出力ハンドラに転送されます。thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名thrown- ログ・メッセージに関連したThrowable。msgSupplier- 呼び出されると、目的のログ・メッセージを生成する関数- 導入されたバージョン:
- 1.8
-
logrb
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg) 非推奨。ソース・クラス、メソッド、およびリソース・バンドル名を指定し、引数のないメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドル名がnull、空のStringのいずれかであるか無効である 合、msg文字列はローカライズされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名bundleName- msgをローカライズするためのリソース・バンドル名。nullも可能msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
logrb
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1) 非推奨。ソース・クラス、メソッド、およびリソース・バンドル名を指定し、ログ・メッセージに対して単一のオブジェクト・パラメータを持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、対応するLogRecordが作成され、登録されたすべての出力Handlerオブジェクトに転送されます。
msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドル名がnull、空のStringのいずれかであるか無効である 合、msg文字列はローカライズされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名bundleName- msgをローカライズするためのリソース・バンドル名。nullも可能msg- 文字列メッセージ、またはメッセージ・カタログのキーparam1- ログ・メッセージのパラメータ。
-
logrb
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params) 非推奨。ソース・クラス、メソッド、およびリソース・バンドル名を指定し、オブジェクトの引数の配列を持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、対応するLogRecordが作成され、登録されたすべての出力Handlerオブジェクトに転送されます。
msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドル名がnull、空のStringのいずれかであるか無効である 合、msg文字列はローカライズされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名bundleName- msgをローカライズするためのリソース・バンドル名。nullも可能。msg- 文字列メッセージ、またはメッセージ・カタログのキーparams- メッセージのパラメータの配列
-
logrb
public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Object... params) ソース・クラス、メソッド、およびリソース・バンドルを指定し、メッセージ・パラメータのオプションのリストを含むメッセージのログを記録します。指定されたメッセージ
levelに対してロガーが現在有効になっている 合、対応するLogRecordが作成され、登録されているすべての出力Handlerオブジェクトに転送されます。msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドルがnullの 合、msg文字列はローカライズされません。- パラメータ:
level- メッセージ・レベル識別子の1つ。例:SEVEREsourceClass- ロギング要求を発行したクラスの名前sourceMethod- ロギング要求を発行したメソッドの名前bundle-msgをローカライズするためのリソース・バンドル、nullも可能。msg- 文字列メッセージ、またはメッセージ・カタログのキーparams- メッセージのパラメータ(オプション、なしの 合もある)。- 導入されたバージョン:
- 1.8
-
logrb
public void logrb(Level level, ResourceBundle bundle, String msg, Object... params) ソース・クラス、メソッド、およびリソース・バンドルを指定し、メッセージ・パラメータのオプションのリストを含むメッセージのログを記録します。指定されたメッセージ
levelに対してロガーが現在有効になっている 合、対応するLogRecordが作成され、登録されているすべての出力Handlerオブジェクトに転送されます。msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドルがnullの 合、msg文字列はローカライズされません。- パラメータ:
level- メッセージ・レベル識別子の1つ。例:SEVEREbundle-msgをローカライズするリソース・バンドル。nullにすることができます。msg- 文字列メッセージ、またはメッセージ・カタログのキーparams- メッセージのパラメータ(オプション、なしの 合もある)。- 導入されたバージョン:
- 9
-
logrb
@Deprecated public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown) 非推奨。ソース・クラス、メソッド、およびリソース・バンドル名を指定し、関連するThrowable情 を持つメッセージのログをとります。指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定された引数が、登録されたすべての出力ハンドラに転送されたLogRecordに 納されます。
msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドル名がnull、空のStringのいずれかであるか無効である 合、msg文字列はローカライズされません。
thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
level- メッセージ・レベル識別子の1つ。たとえば、SEVEREsourceClass- ロギングの要求を発行したクラス名sourceMethod- ロギングの要求を発行したメソッド名bundleName- msgをローカライズするためのリソース・バンドル名。nullも可能msg- 文字列メッセージ、またはメッセージ・カタログのキーthrown- ログ・メッセージに関連したThrowable。
-
logrb
public void logrb(Level level, String sourceClass, String sourceMethod, ResourceBundle bundle, String msg, Throwable thrown) ソース・クラス、メソッド、およびリソース・バンドルを指定し、関連するThrowable情 を含むメッセージのログを記録します。指定されたメッセージ
levelに対してロガーが現在有効になっている 合、指定された引数は、登録されているすべての出力ハンドラに転送されるLogRecordに 納されます。msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドルがnullの 合、msg文字列はローカライズされません。thrown引数は、LogRecordparametersプロパティではなく、LogRecordthrownプロパティに 納されることに注意してく さい。 したがって、出力Formatterオブジェクトによって特別に処理され、LogRecordmessageプロパティのフォーマット・パラメータとして扱われません。- パラメータ:
level- メッセージ・レベル識別子の1つ。例:SEVEREsourceClass- ロギング要求を発行したクラスの名前sourceMethod- ロギング要求を発行したメソッドの名前bundle-msgをローカライズするためのリソース・バンドル、nullも可能msg- 文字列メッセージ、またはメッセージ・カタログのキーthrown- ログ・メッセージに関連したThrowable。- 導入されたバージョン:
- 1.8
-
logrb
public void logrb(Level level, ResourceBundle bundle, String msg, Throwable thrown) ソース・クラス、メソッド、およびリソース・バンドルを指定し、関連するThrowable情 を含むメッセージのログを記録します。指定されたメッセージ
levelに対してロガーが現在有効になっている 合、指定された引数は、登録されているすべての出力ハンドラに転送されるLogRecordに 納されます。msg文字列は、指定されたリソース・バンドルを使ってローカライズされます。 リソース・バンドルがnullの 合、msg文字列はローカライズされません。thrown引数は、LogRecordparametersプロパティではなく、LogRecordthrownプロパティに 納されることに注意してく さい。 したがって、出力Formatterオブジェクトによって特別に処理され、LogRecordmessageプロパティのフォーマット・パラメータとして扱われません。- パラメータ:
level- メッセージ・レベル識別子の1つ。例:SEVEREbundle-msgをローカライズするリソース・バンドル。nullにすることができます。msg- 文字列メッセージ、またはメッセージ・カタログのキーthrown- ログ・メッセージに関連したThrowable。- 導入されたバージョン:
- 9
-
entering
-
entering
1つのパラメータを持つメソッド・エントリのログをとります。これは、メソッドへのエントリのロギングに使用可能な簡易メソッドです。 メッセージ「ENTRY {0}」、ログ・レベルFINER、および指定されたsourceMethod、sourceClass、パラメータを含むLogRecordが、ロギングされます。
- パラメータ:
sourceClass- ロギングの要求を発行したクラス名sourceMethod- エントリしているメソッド名param1- エントリしているメソッドのパラメータ
-
entering
パラメータの配列を持つメソッド・エントリのログをとります。これは、メソッドへのエントリのロギングに使用可能な簡易メソッドです。 メッセージ「ENTRY」(パラメータ配列内のエントリごとにフォーマット{N}インジケータが1つずつ続く)、ログ・レベルFINER、および指定されたsourceMethod、sourceClass、パラメータを含むLogRecordが、ロギングされます。
- パラメータ:
sourceClass- ロギングの要求を発行したクラス名sourceMethod- エントリしているメソッド名params- エントリしているメソッドのパラメータの配列
-
exiting
-
exiting
結果オブジェクトを持つメソッド復帰のログをとります。これは、メソッドからの復帰のロギングに使用可能な簡易メソッドです。 メッセージ「RETURN {0}」、ログ・レベルFINER、および指定されたsourceMethod、sourceClass、結果オブジェクトを含むLogRecordが、ロギングされます。
- パラメータ:
sourceClass- ロギングの要求を発行したクラス名sourceMethod- メソッドの名前result- 返されたオブジェクト
-
throwing
例外をスローするログをとります。これは、あるメソッドが例外をスローして終了したことをロギングするための簡易メソッドです。 このロギングはFINERレベルを使って行われます。
指定されたメッセージ・レベルで現在ロガーが使用可能な 合、指定された引数が、登録されたすべての出力ハンドラに転送されたLogRecordに 納されます。 LogRecordのmessageが「THROW」に設定されます。
thrown引数は、LogRecordのparametersプロパティにではなく、LogRecordのthrownプロパティに 納されることに注意してく さい。 このため、それは出力Formatterによって特別な方法で処理され、LogRecordのmessageプロパティに対するフォーマット処理パラメータとはみなされません。
- パラメータ:
sourceClass- ロギングの要求を発行したクラス名sourceMethod- メソッドの名前。thrown- スローされたThrowable。
-
severe
public void severe(String msg) SEVEREメッセージのログをとります。SEVEREメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力ハンドラに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
warning
public void warning(String msg) WARNINGメッセージのログをとります。WARNINGメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
info
public void info(String msg) INFOメッセージのログをとります。INFOメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
config
public void config(String msg) CONFIGメッセージのログをとります。CONFIGメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
fine
public void fine(String msg) FINEメッセージのログをとります。FINEメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
finer
public void finer(String msg) FINERメッセージのログをとります。FINERメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
finest
public void finest(String msg) FINESTメッセージのログをとります。FINESTメッセージ・レベルで現在ロガーが使用可能な 合、指定されたメッセージは登録されたすべての出力Handlerオブジェクトに転送されます。
- パラメータ:
msg- 文字列メッセージ、またはメッセージ・カタログのキー
-
severe
-
warning
-
info
-
config
-
fine
-
finer
-
finest
-
setLevel
public void setLevel(Level newLevel) このロガーがどのメッセージ・レベルをロギングするかを指定するログ・レベルを設定します。 この値より小さいメッセージ・レベルは 棄されます。 レベル値Level.OFFを使えば、ロギングをオフにできます。新しいレベルがnullの 合、このノードがnull以外の特定のレベル値を持つもっとも近い上位ノードから、そのレベルを継承することを意味します。
- パラメータ:
newLevel- ログ・レベルの新しい値(nullの 合がある)
-
getLevel
public Level getLevel()このLoggerに指定されたログLevelを取得します。 結果はnullになる 合もありますが、それは、このロガーの実効レベルが親から継承されることを意味します。- 戻り値:
- このLoggerのレベル
-
isLoggable
public boolean isLoggable(Level level) 指定されたレベルのメッセージがこのロガーによって実際にロギングされるかどうかをチェックします。 このチェックは、親から継承される可能性のあるLoggerの実効レベルに基づいて行われます。- パラメータ:
level- メッセージのログをとるレベル- 戻り値:
- 指定されたメッセージ・レベルで現在ログがとられている 合はtrue
-
getName
-
addHandler
public void addHandler(Handler handler) ログHandlerを追 してログ・メッセージを受け取ります。デフォルトでは、ロガーは自分の親ロガーにも出力を送信します。 ルートLoggerは通常、基本的にすべてのロガーのデフォルト・ハンドラとして機能する一連のHandlerを持つように構成されます。
- パラメータ:
handler- ログHandler
-
removeHandler
public void removeHandler(Handler handler) ログHandlerを削除します。指定されたHandlerが見つからないかnullの 合は何も行わずに復帰します。
- パラメータ:
handler- ログHandler
-
getHandlers
-
setUseParentHandlers
public void setUseParentHandlers(boolean useParentHandlers) このロガーが出力をその親ロガーに送信すべきかどうかを指定します。 つまり、すべてのLogRecordがその親のHandlerにも書き込まれ、 合によってはそのまた親のHandlerにも書き込まれます。これが、名前空間の上方に向けて繰り返されます。- パラメータ:
useParentHandlers- 出力がロガーの親に送信される 合はtrue。
-
getUseParentHandlers
public boolean getUseParentHandlers()このロガーが出力をその親ロガーに送信しているかどうかを検出します。- 戻り値:
- 出力がロガーの親に送信される 合はtrue
-
setResourceBundle
public void setResourceBundle(ResourceBundle bundle) このロガーのリソース・バンドルを設定します。 その特定のロケールの指定されたリソース・バンドルを使用して、すべてのメッセージがログに記録されます。- パラメータ:
bundle- このロガーが使用するリソース・バンドル。- スロー:
NullPointerException- 指定されたバンドルがnullの 合。IllegalArgumentException- 指定されたバンドルに基底名がない 合、またはこのロガーにすでにリソース・バンドルが設定されているが、指定されたバンドルの基底名が異なる 合。- 導入されたバージョン:
- 1.8
-
getParent
public Logger getParent()このロガーの親を返します。このメソッドは名前空間でもっとも近い現存する親を返します。 したがって、Loggerが「a.b.c.d」と呼ばれ、「a.b」と呼ばれるLoggerが作成されて、ロガー「a.b.c」が存在しない 合、Logger「a.b.c.d」のgetParentの呼出しはLogger「a.b」を返します。
名前空間のルートLoggerを呼び出す 合、結果はnullになります。
- 戻り値:
- もっとも近い既存の親Logger
-
setParent
public void setParent(Logger parent) このロガーの親を設定します。 このメソッドは、名前空間の変更時にLoggerを更新するために、LogManagerによって使用されます。これはアプリケーション・コードから呼び出してはいけません。
- パラメータ:
parent- 新しい親ロガー
-