|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.util.logging.LogManager
public class LogManager
存在一个单一的全局 LogManager 对象,它可用于维护 Logger 和日志服务的一组共享状态。
此 LogManager 对象:
可以使用 LogManager.getLogManager() 获取全局 LogManager 对象。LogManager 对象是在类初始化过程中创建的,过后便不能更改。
在启动时,使用 java.util.logging.manager 系统属性定位 LogManager 类。
默认情况下,LogManager 从 JRE 目录的属性文件 "lib/logging.properties" 中读取其初始配置。如果编辑该属性文件,则可更改此 JRE 的所有用户的默认日志配置。
另外,LogManager 使用两个可选的允许更好地控制初始配置读取的系统属性:
如果设置了 "java.util.logging.config.class" 属性,则会把属性值当作类名。给定的类将会被加载,并会实例化一个对象,该对象的构造方法负责读取初始配置。(此对象可以使用其他系统属性来控制自己的配置。)此备用配置类可使用 readConfiguration(InputStream) 来定义 LogManager 中的属性。
如果未设置 "java.util.logging.config.class" 属性,则会使用 "java.util.logging.config.file" 系统属性来指定一个属性文件(以 java.util.Properties 格式)。从此文件读取初始日志配置。
如果这两个属性都没有定义,则如上所述,LogManager 将从 JRE 目录的属性文件 "lib/logging.properties" 中读取其初始配置。
Logger 和 Handler 的属性名称是以圆点分隔的 Logger 或 Handler 的名称开头。
全局日志属性可以包括:
注意,在 LogManager 配置期间加载的所有类,其搜索顺序是先从系统类路径中搜索,然后才从用户类中搜索。这包括 LogManager 类、任何 config 类和任何 handler 类。
Logger 是按其圆点分隔的名称被组织到命名层次结构中的。因此,"a.b.c" 是 "a.b" 的子级,但 "a.b1" 和 a.b2" 属于同一级。
假定所有以 ".level" 结尾的名称的属性为 Logger 定义日志级别。因此,"foo.level" 就为名称为 "foo" 的 logger 定义了日志级别,进而为指定层次结构中它的所有子级也逐个定义了日志级别。日志级别是按其在属性文件中的定义顺序应用的。因此,树中子节点的级别设置应该迟于其父级设置。属性名 ".level" 可用于设置树的根级。
LogManager 对象上的所有方法都是多线程安全的。
字段摘要 | |
---|---|
static String |
LOGGING_MXBEAN_NAME LoggingMXBean 的 ObjectName 的字符串表示形式。 |
构造方法摘要 | |
---|---|
protected |
LogManager() 受保护的构造方法。 |
方法摘要 | |
---|---|
boolean |
addLogger(Logger logger) 添加指定的 logger。 |
void |
addPropertyChangeListener(PropertyChangeListener l) 添加重读日志属性时调用的事件侦听器。 |
void |
checkAccess() 检查使用当前上下文来修改日志配置是否受信任。 |
Logger |
getLogger(String name) 查找指定 logger 的方法。 |
Enumeration<String> |
getLoggerNames() 获取已知 logger 名称的枚举。 |
static LoggingMXBean |
getLoggingMXBean() 返回管理 logger 的 LoggingMXBean。 |
static LogManager |
getLogManager() 返回全局 LogManager 对象。 |
String |
getProperty(String name) 获取日志属性的值。 |
void |
readConfiguration() 重新初始化日志属性并重新读取日志配置。 |
void |
readConfiguration(InputStream ins) 从给定流重新初始化并重新读取日志配置,该配置为 java.util.Properties 格式。 |
void |
removePropertyChangeListener(PropertyChangeListener l) 移除属性更改事件的事件侦听器。 |
void |
reset() 重置日志配置。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final String LOGGING_MXBEAN_NAME
LoggingMXBean
的
ObjectName
的字符串表示形式。
构造方法详细信息 |
---|
protected LogManager()
方法详细信息 |
---|
public static LogManager getLogManager()
public void addPropertyChangeListener(PropertyChangeListener l) throws SecurityException
l
- 事件侦听器
SecurityException
- 如果存在安全管理器,且调用者不具有 LoggingPermission("control")。
NullPointerException
- 如果 PropertyChangeListener 为 null。
public void removePropertyChangeListener(PropertyChangeListener l) throws SecurityException
addPropertyChangeListener
在侦听器表中添加同一个侦听器实例,则需要调用相同数目的
removePropertyChangeListener
将该侦听器的所有实例从侦听器表中移除。
如果未找到给定的侦听器,则默认返回。
l
- 事件侦听器(可以为 null)
SecurityException
- 如果存在安全管理器,且调用者不具有 LoggingPermission("control")。
public boolean addLogger(Logger logger)
Logger 工厂方法调用此方法来注册每个新创建的 Logger。
此应用程序应该保留其自身对 Logger 对象的引用,以避免自己被作为无用信息收集。LogManager 仅可能保留弱引用。
logger
- 新 logger。
NullPointerException
- 如果 logger 名称为 null。
public Logger getLogger(String name)
注意,由于不受信任的代码可能使用任意名称创建 logger,不能依赖于此方法为安全性敏感的日志查找 Logger。
name
- logger 的名称
public Enumeration<String> getLoggerNames()
注:加载新类时可能动态添加 Logger。此方法仅报告当前已注册的 logger。
public void readConfiguration() throws IOException, SecurityException
使用与启动时相同的规则查找配置属性。因此,通常从启动时使用过的文件重新读取日志属性。
如果目标 Logger 存在,则使用 Logger.setLevel() 来应用新配置文件中的所有日志级别定义。
读取这些属性后将激发 PropertyChangeEvent。
SecurityException
- 如果安全管理器存在并且调用者不具有 LoggingPermission("control")。
IOException
- 如果读取配置时存在 IO 问题。
public void reset() throws SecurityException
对于所有指定的 logger,重置操作移除并关闭全部 Handler(除了根 logger 之外),并将级别设置为 null。根 logger 的级别设置为 Level.INFO。
SecurityException
- 如果安全管理器存在并且调用者不具有 LoggingPermission("control")。
public void readConfiguration(InputStream ins) throws IOException, SecurityException
如果目标 Logger 存在,则使用 Logger.setLevel() 来应用新配置文件中的所有日志级别定义。
ins
- 从中读取属性的流
SecurityException
- 如果存在安全管理器,且调用者不具有 LoggingPermission("control")。
IOException
- 如果从流读取时存在问题。
public String getProperty(String name)
name
- 属性名
public void checkAccess() throws SecurityException
如果此检查失败,则抛出 SecurityException;否则,正常返回。
SecurityException
- 如果安全管理器存在并且调用者不具有 LoggingPermission("control")。
public static LoggingMXBean getLoggingMXBean()
平台的 MBeanServer
方法得到。
LoggingMXBean
对象。
ManagementFactory
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。