モジュール java.base

パッケージ java.lang

インタフェースSystem.Logger

含まれているクラス:

System

public static interface System.Logger

System.Loggerインスタンスは、LoggerFinderが使用する基礎となるロギング・フレームワークにルーティングされるメッセージをログに記録します。 System.Loggerインスタンスは通常、System.getLogger(loggerName)またはSystem.getLogger(loggerName, bundle)を呼び出してSystemクラスから取得します。

導入されたバージョン:

9

関連項目:

• System.getLogger(java.lang.String)
• System.getLogger(java.lang.String, java.util.ResourceBundle)
• System.LoggerFinder

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェース	説明
static enum	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の場合。