LoggingMXBean - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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。

概述