-
- 含まれているクラス:
- System
public static interface System.Logger
System.Logger
インスタンスは、LoggerFinder
が使用する基礎となるロギング・フレームワークにルーティングされるログ・メッセージを記録します。System.Logger
インスタンスは通常、System.getLogger(loggerName)
またはSystem.getLogger(loggerName, bundle)
を呼び出してSystem
クラスから取得します。
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 インタフェース 説明 static class
System.Logger.Level
システムloggersレベル。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 修飾子と型 メソッド 説明 String
getName()
このロガーの名前を返します。boolean
isLoggable(System.Logger.Level level)
指定されたレベルのメッセージがこのロガーによってログに記録されるかどうかをチェックします。default void
log(System.Logger.Level level, Object obj)
指定されたオブジェクトから生成されたメッセージを記録します。default void
log(System.Logger.Level level, String msg)
メッセージを記録します。default void
log(System.Logger.Level level, String format, Object... params)
オプションのパラメータ・リストを含むメッセージを記録します。default void
log(System.Logger.Level level, String msg, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられたメッセージをログに記録します。default void
log(System.Logger.Level level, Supplier<String> msgSupplier)
遅延メッセージを記録します。default void
log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられた遅延メッセージを記録します。void
log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)
リソース・バンドルとオプションのパラメータ・リストを含むメッセージをログに記録します。void
log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられたローカライズされたメッセージを記録します。
-
-
-
メソッドの詳細
-
getName
String getName()
このロガーの名前を返します。- 戻り値:
- ロガー名。
-
isLoggable
boolean isLoggable(System.Logger.Level level)
指定されたレベルのメッセージがこのロガーによってログに記録されるかどうかをチェックします。- パラメータ:
level
- ログ・メッセージ・レベル。- 戻り値:
- 指定されたログ・メッセージ・レベルが現在ログに記録されている場合は
true
。 - 例外:
NullPointerException
-level
がnull
の場合。
-
log
default void log(System.Logger.Level level, String msg)
メッセージを記録します。- 実装要件:
- このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, msg, (Object[])null);
- パラメータ:
level
- ログ・メッセージ・レベル。msg
- 文字列メッセージ(このロガーがlocalized logger
の場合はメッセージ・カタログ内のキー);null
にすることができます。- 例外:
NullPointerException
-level
がnull
の場合。
-
log
default void log(System.Logger.Level level, Supplier<String> msgSupplier)
遅延メッセージを記録します。 指定されたログ・メッセージ・レベルでロガーが現在有効になっている場合は、指定されたサプライヤ関数によって生成された結果であるメッセージがログに記録されます。 そうでなければ、サプライヤは操作されません。- 実装要件:
- 指定されたレベルでロギングが有効になっている場合、このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, msgSupplier.get(), (Object[])null);
- パラメータ:
level
- ログ・メッセージ・レベル。msgSupplier
- メッセージを生成するサプライヤ関数。- 例外:
NullPointerException
-level
がnull
の場合、またはmsgSupplier
がnull
の場合。
-
log
default void log(System.Logger.Level level, Object obj)
指定されたオブジェクトから生成されたメッセージを記録します。 指定されたログ・メッセージ・レベルでロガーが現在有効になっている場合、デフォルトでは、指定されたオブジェクトでtoStringを呼び出すことによって生成される結果がメッセージに記録されます。 それ以外の場合、オブジェクトは操作されません。- 実装要件:
- 指定されたレベルでロギングが有効になっている場合、このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, obj.toString(), (Object[])null);
- パラメータ:
level
- ログ・メッセージ・レベル。obj
- ログするオブジェクト。- 例外:
NullPointerException
-level
がnull
の場合、またはobj
がnull
の場合。
-
log
default void log(System.Logger.Level level, String msg, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられたメッセージをログに記録します。- 実装要件:
- このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, msg, thrown);
- パラメータ:
level
- ログ・メッセージ・レベル。msg
- 文字列メッセージ(このロガーがlocalized logger
の場合はメッセージ・カタログ内のキー);null
にすることができます。thrown
- ログ・メッセージに関連付けられたThrowable
。null
にすることができます。- 例外:
NullPointerException
-level
がnull
の場合。
-
log
default void log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられた遅延メッセージを記録します。 指定されたログ・メッセージ・レベルでロガーが現在有効になっている場合は、指定されたサプライヤ関数によって生成された結果であるメッセージがログに記録されます。 そうでなければ、サプライヤは操作されません。- 実装要件:
- 指定されたレベルでロギングが有効になっている場合、このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, msgSupplier.get(), thrown);
- パラメータ:
level
- ログ・メッセージ・レベル識別子の1つ。msgSupplier
- メッセージを生成するサプライヤ関数。thrown
- ログ・メッセージに関連付けられたThrowable
。null
にすることができます。- 例外:
NullPointerException
-level
がnull
の場合、またはmsgSupplier
がnull
の場合。
-
log
default void log(System.Logger.Level level, String format, Object... params)
オプションのパラメータ・リストを含むメッセージを記録します。- 実装要件:
- このメソッドのデフォルトの実装では、
this.log(level, (ResourceBundle)null, format, params);
- パラメータ:
level
- ログ・メッセージ・レベル識別子の1つ。format
-MessageFormat
形式の文字列メッセージ形式、(このロガーがlocalized logger
の場合はメッセージ・カタログ内のキー);null
にすることができます。params
- メッセージ(可能性はありません)に対するオプションのパラメータ・リスト。- 例外:
NullPointerException
-level
がnull
の場合。
-
log
void log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)
指定されたスロー可能オブジェクトに関連付けられたローカライズされたメッセージを記録します。 指定されたリソース・バンドルがnull
以外の場合、msg
文字列は、指定されたリソース・バンドルを使用してローカライズされます。 それ以外の場合、msg
文字列はローカライズされません。- パラメータ:
level
- ログ・メッセージ・レベル。bundle
-msg
をローカライズするリソース・バンドル。null
にすることができます。msg
- 文字列メッセージ(bundle
がnull
でない場合は、メッセージ・カタログ内のキー);null
にすることができます。thrown
- ログ・メッセージに関連付けられたThrowable
。null
にすることができます。- 例外:
NullPointerException
-level
がnull
の場合。
-
log
void log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)
リソース・バンドルとオプションのパラメータ・リストを含むメッセージをログに記録します。 指定されたリソース・バンドルがnull
以外の場合、format
文字列は、指定されたリソース・バンドルを使用してローカライズされます。 それ以外の場合、format
文字列はローカライズされません。- パラメータ:
level
- ログ・メッセージ・レベル。bundle
-format
をローカライズするリソース・バンドル。null
にすることができます。format
-MessageFormat
形式の文字列メッセージ形式、(bundle
がnull
でない場合は、メッセージ・カタログ内のキー);null
にすることができます。params
- メッセージ(可能性はありません)に対するオプションのパラメータ・リスト。- 例外:
NullPointerException
-level
がnull
の場合。
-
-