compact1, compact2, compact3

java.util.logging

Interface LoggingMXBean

public interface LoggingMXBean

记录设备的管理界面。 建议使用PlatformLoggingMXBean实施本定义的所有属性的管理界面LoggingMXBean 。 ManagementFactory.getPlatformMXBean方法可用于获取表示用于记录的管理界面的PlatformLoggingMXBean对象。

LoggingMXBean有一个全局实例。 这个实例是一个MXBean ，可以通过调用LogManager.getLoggingMXBean()方法或从platform MBeanServer获得 。

该ObjectName唯一标识的管理界面进行日志记录的内MBeanServer是：

  java.util.logging:type=Logging 

登录平台MBeanServer的实例也是PlatformLoggingMXBean 。

从以下版本开始：

1.5

另请参见：

PlatformLoggingMXBean

方法摘要

Modifier and Type	Method and Description
String	getLoggerLevel(String loggerName) 获取与指定记录器关联的日志级别的名称。
List<String>	getLoggerNames() 返回当前注册的记录器名称的列表。
String	getParentLoggerName(String loggerName) 返回指定记录器的父级名称。
void	setLoggerLevel(String loggerName, String levelName) 将指定的记录器设置为指定的新级别。

方法详细信息

getLoggerNames

List<String> getLoggerNames()

返回当前注册的记录器名称的列表。 此方法调用LogManager.getLoggerNames()并返回一个记录器名称列表。

结果

String的名单， 其中的每一个都是当前 注册的Logger名称。

getLoggerLevel

String getLoggerLevel(String loggerName)

获取与指定记录器关联的日志级别的名称。 如果指定的记录器不存在，则返回null 。 此方法首先找到给定名称的记录器，然后通过调用以下命令返回日志级别的名称：

Logger.getLevel(). getName();

如果指定的记录器的Level是null ，这意味着这个记录器的有效级别是从其父级继承的，将返回一个空字符串。

参数

loggerName - 要检索的 Logger的名称。

结果

指定记录器的日志级别的名称; 如果指定的记录器的日志级别为null， 则为空字符串。 如果指定的记录器不存在，则返回null 。

另请参见：

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)

将指定的记录器设置为指定的新级别。 如果levelName不是null ，则指定记录器的级别设置为与levelName匹配的解析的Level 。 如果levelName是null ，则指定记录器的级别设置为null ，并且记录器的有效级别从具有（非空）级别值的最近祖先继承。

参数

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

levelName - 要在指定记录器上设置的级别的名称，如果设置级别从其最近的祖先继承， 则为null 。

异常

IllegalArgumentException - 如果指定的记录器不存在，或 levelName不是有效的级别名称。

SecurityException - 如果安全管理器存在，并且调用者没有LoggingPermission（“control”）。

另请参见：

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

getParentLoggerName

String getParentLoggerName(String loggerName)

返回指定记录器的父级名称。 如果指定的记录器不存在，则返回null 。 如果指定的记录器是命名空间中的根目录Logger ，则结果将为空字符串。

参数

loggerName - 一个 Logger的名字。

结果

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