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