モジュール 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 class	System.Logger.Level	システムロガーレベル。

メソッドのサマリー

修飾子と型	メソッド	説明
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)	指定されたthrowableに関連付けられた遅延指定メッセージをログに記録します。
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)

指定されたthrowableに関連付けられた遅延指定メッセージをログに記録します。 指定されたログ・メッセージ・レベルでロガーが現在有効になっている場合は、指定されたサプライヤ機能によって生成された結果であるメッセージがログに記録されます。 それ以外の場合、サプライヤは操作されません。

実装要件:

指定されたレベルでロギングが有効な場合、このメソッドのデフォルト実装は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の場合。