compact3

java.lang.management

Interface PlatformLoggingMXBean

All Superinterfaces:

PlatformManagedObject

public interface PlatformLoggingMXBean
extends PlatformManagedObject

logging设施的管理界面 。

PlatformLoggingMXBean有一个全局实例。 ManagementFactory.getPlatformMXBean方法可用于获取PlatformLoggingMXBean对象，如下所示：

  PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class); 

PlatformLoggingMXBean对象也注册到平台MBeanServer 。 该ObjectName用于唯一地识别PlatformLoggingMXBean MBeanServer中是：

  java.util.logging:type=Logging 

在MBeanServer平台上注册的实例具有ObjectName实现LoggingMXBean定义的所有属性 。

从以下版本开始：

1.7

方法摘要

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

Methods inherited from interface java.lang.management.PlatformManagedObject

getObjectName

方法详细信息

getLoggerNames

List<String> getLoggerNames()

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

结果

一份 String的名单， String每一个都是当前 Logger名称。

getLoggerLevel

String getLoggerLevel(String loggerName)

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

Logger.getLevel(). getName();

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

参数

loggerName - 要检索的 Logger的名称。

结果

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

另请参见：

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)

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

参数

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

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

异常

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

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

另请参见：

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

getParentLoggerName

String getParentLoggerName(String loggerName)

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

参数

loggerName - 一个 Logger的名字。

结果

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