JavaTM 2 Platform
Standard Ed. 5.0

java.util.logging
接口 LoggingMXBean


public interface LoggingMXBean

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

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

在 MBeanServer 中惟一标识 LoggingMXBeanObjectName 是:

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 的 Levelnull(这意味着此 logger 的有效级别继承自它的父亲),则返回一个空字符串。

参数:
loggerName - 要检索的 Logger 的名称。
返回:
指定 logger 的日志级别的名称;如果指定 logger 的日志级别为 null,则返回一个空字符串。如果指定 logger 不存在,则返回 null
另请参见:
Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)
将指定 logger 设置为指定的新级别。如果 levelName 不为 null,则将指定 logger 的级别设置为与 levelName 匹配的、分析后的 Level。如果 levelNamenull,则将指定 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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策