インタフェース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の 合。
-