Module java.base
Package java.lang

Interface System.Logger

封闭类:
System
public static interface System.Logger
System.Logger 实例记录消息，这些消息将被路由到底层日志框架LoggerFinder使用的。通常可以通过从System类获取System.Logger实例，通过调用System.getLogger(loggerName)或System.getLogger(loggerName, bundle)来获得。
自 JDK 版本:
9
参见:

  • Method Details

    • 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 - 字符串消息（或消息目录中的键，如果此日志记录器是本地化日志记录器）；可以为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 - 字符串消息（或消息目录中的键，如果此日志记录器是本地化日志记录器）；可以为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格式的字符串消息格式（或消息目录中的键，如果此日志记录器是本地化日志记录器）；可以为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。