方法详细信息

• 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 - 消息的可选参数列表（可以是none）。

  异常

  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 - 消息的可选参数列表（可以是none）。

  异常

  NullPointerException - 如果 level是 null 。