Module java.base

软件包 java.lang

Interface System.Logger

Enclosing class:

System

public static interface System.Logger

System.Logger实例日志消息将路由到底层日志框架LoggerFinder使用。

System.Logger实例通常是从System类获得的，通过调用System.getLogger(loggerName)或System.getLogger(loggerName, bundle) 。

从以下版本开始：

9

另请参见：

System.getLogger(java.lang.String) ， System.getLogger(java.lang.String, java.util.ResourceBundle) ， System.LoggerFinder

Nested Class Summary

Nested Classes

Modifier and Type	接口	描述
static class	System.Logger.Level	系统loggers级别。

方法摘要

Modifier and Type	方法	描述
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 - 其中一个日志消息级标识符。

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)

记录与给定的可抛物线相关联的本地化消息。

如果给定的资源束不是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 。