模块 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
参见：

  • 方法详情

    • 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)
      记录与给定 throwable 关联的消息。
      实现要求：
      此方法的默认实现调用 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 - 日志消息级别标识符之一。
      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 - 日志消息级别标识符之一。
      format - MessageFormat 格式的字符串消息格式（或消息目录中的键，如果此记录器是 localized logger ）；可以是 null 。
      params - 消息的可选参数列表（可能没有）。
      抛出：
      NullPointerException - 如果 level 是 null。

    • log

      void log(System.Logger.Level  level, ResourceBundle  bundle, String  msg, Throwable  thrown)
      记录与给定 throwable 关联的本地化消息。如果给定的资源包是非 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。