モジュール 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	システム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の場合。