インタフェースSystem.Logger
- 含まれているクラス:
System
public static interface System.Logger
System.Loggerインスタンスは、LoggerFinderが使用する基礎となるロギング・フレームワークにルーティングされるメッセージをログに記録します。 System.Loggerインスタンスは通常、System.getLogger(loggerName)またはSystem.getLogger(loggerName, bundle)を呼び出してSystemクラスから取得します。 - 導入されたバージョン:
- 9
- 関連項目:
-
ネストされたクラスのサマリー
ネストされたクラス -
メソッドのサマリー
修飾子と型メソッド説明getName()このロガーの名前を返します。booleanisLoggable(System.Logger.Level level) 指定されたレベルのメッセージがこのロガーによってログに記録されるかどうかを確認します。default voidlog(System.Logger.Level level, Object obj) 指定されたオブジェクトから生成されたメッセージをログに記録します。default voidlog(System.Logger.Level level, String msg) メッセージを記録します。default voidlog(System.Logger.Level level, String format, Object... params) オプションのパラメータ・リストを含むメッセージをログに記録します。default voidlog(System.Logger.Level level, String msg, Throwable thrown) 特定のスロー可能オブジェクトに関連付けられたメッセージをログに記録します。default voidlog(System.Logger.Level level, Supplier<String> msgSupplier) 遅延して指定されたメッセージをログに記録します。default voidlog(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown) 指定されたスロー可能オブジェクトに関連付けられた、遅延で提供されたメッセージをログに記録します。voidlog(System.Logger.Level level, ResourceBundle bundle, String format, Object... params) リソース・バンドルおよびオプションのパラメータ・リストを含むメッセージをログに記録します。voidlog(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown) 特定のスロー可能オブジェクトに関連付けられたローカライズされたメッセージをログに記録します。
-
メソッドの詳細
-
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の場合。
-