java.util.logging
接口 LoggingMXBean

public interface LoggingMXBean

日志记录设施的管理接口。

存在单个 LoggingMXBean 的全局实例。此实例是一个 MXBean，可通过调用 LogManager.getLoggingMXBean() 得到，或者从 platform MBeanServer 方法得到。

在 MBeanServer 中唯一标识 LoggingMXBean 的 ObjectName 是：

java.util.logging:type=Logging

从以下版本开始：

1.5

另请参见：

ManagementFactory

方法摘要

String	getLoggerLevel(String loggerName) 获取与指定 logger 相关的日志级别名称。
List<String>	getLoggerNames() 返回当前已注册的 logger 列表。
String	getParentLoggerName(String loggerName) 返回指定 logger 的父 logger 名称。
void	setLoggerLevel(String loggerName, String levelName) 将指定 logger 设置为指定的新级别。

方法详细信息

getLoggerNames

List<String> getLoggerNames()

返回当前已注册的 logger 列表。此方法调用 LogManager.getLoggerNames()，并返回 logger 的名称列表。

返回：

String 列表，其中每一项都是一个当前已注册的 Logger 名称。

getLoggerLevel

String getLoggerLevel(String loggerName)

获取与指定 logger 相关的日志级别名称。如果指定 logger 不存在，则返回 null。此方法首先查找给定名称的 logger ，然后返回日志级别的名称，这通过调用以下方法来实现：

Logger.getLevel().getName();

如果指定 logger 的 Level 为 null（这意味着此 logger 的有效级别继承自它的父 logger），则返回一个空字符串。

参数：

loggerName - 要获取的 Logger 的名称。

返回：

指定 logger 的日志级别的名称；如果指定 logger 的日志级别为 null，则返回一个空字符串。如果指定 logger 不存在，则返回 null。

另请参见：

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)

将指定 logger 设置为指定的新级别。如果 levelName 不为 null，则将指定 logger 的级别设置为与 levelName 匹配的、解析后的 Level。如果 levelName 为 null，则将指定 logger 的级别设置为 null，并且其有效级别继承自最近的祖先（带特定的非 null 级别值）。

参数：

loggerName - 要设置的 Logger 的名称。必须为非 null。

levelName - 指定 logger 所要设置的级别名称，如果设置该级别继承其最近的祖先，则为 null。

抛出：

IllegalArgumentException - 如果指定 logger 不存在，或 levelName 不是一个有效的级别名称。

SecurityException - 如果安全管理器存在并且调用者不具有 LoggingPermission("control")。

另请参见：

Logger.setLevel(java.util.logging.Level)

getParentLoggerName

String getParentLoggerName(String loggerName)

返回指定 logger 的父 logger 名称。如果指定 logger 不存在，则返回 null。如果指定 logger 是名称空间中的根 Logger，则结果是一个空字符串。

参数：

loggerName - Logger 的名称。

返回：

最近的现有父 logger 的名称；如果指定的 logger 是根 logger ，则返回一个空字符串。如果指定 logger 不存在，则返回 null。