模块 java.base

软件包 java.lang

Interface System.Logger

Enclosing class:

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)	记录与给定throwable关联的消息。
default void	log(System.Logger.Level level, Supplier<String> msgSupplier)	记录延迟提供的消息。
default void	log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)	记录与给定throwable关联的延迟提供的消息。
void	log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)	使用资源包和可选的参数列表记录消息。
void	log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)	记录与给定throwable关联的本地化消息。

方法详细信息

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 。