LogManager

public class LogManager
extends Object

有一个全局LogManager对象用于维护一组关于Loggers和Log服务的共享状态。

这个LogManager对象：

• Manages a hierarchical namespace of Logger objects. All named Loggers are stored in this namespace.
• Manages a set of logging control properties. These are simple key-value pairs that can be used by Handlers and other logging objects to configure themselves.

全局LogManager对象可以使用LogManager.getLogManager（）来检索。 LogManager对象是在类初始化期间创建的，不能随后进行更改。

在启动时，LogManager类使用java.util.logging.manager系统属性进行定位。

默认情况下，LogManager从JRE目录中的属性文件“lib / logging.properties”中读取其初始配置。 如果您编辑该属性文件，则可以更改该JRE所有用途的默认日志记录配置。

另外，LogManager使用两个可选的系统属性，可以更多地控制读取初始配置：

• "java.util.logging.config.class"
• "java.util.logging.config.file"

如果设置了“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”中读取其初始配置。

记录器和处理程序的属性将具有以处理程序或记录器的点分隔名称开头的名称。

全局日志记录属性可能包括：

• A property "handlers". This defines a whitespace or comma separated list of class names for handler classes to load and register as handlers on the root Logger (the Logger named ""). Each class name must be for a Handler class which has a default constructor. Note that these Handlers may be created lazily, when they are first used.
• A property "<logger>.handlers". This defines a whitespace or comma separated list of class names for handlers classes to load and register as handlers to the specified logger. Each class name must be for a Handler class which has a default constructor. Note that these Handlers may be created lazily, when they are first used.
• A property "<logger>.useParentHandlers". This defines a boolean value. By default every logger calls its parent in addition to handling the logging message itself, this often result in messages being handled by the root logger as well. When setting this property to false a Handler needs to be configured for this logger otherwise no logging messages are delivered.
• A property "config". This property is intended to allow arbitrary configuration code to be run. The property defines a whitespace or comma separated list of class names. A new instance will be created for each named class. The default constructor of each class may execute arbitrary code to update the logging configuration, such as setting logger levels, adding handlers, adding filters, etc.

请注意，在LogManager配置期间加载的所有类首先在任何用户类路径之前的系统类路径中进行搜索。 这包括LogManager类，任何配置类和任何处理程序类。

记录器根据它们的点分隔名称被组织到命名层次结构中。 因此“abc”是“ab”的孩子，但是“a.b1”和a.b2“是同伴。

假设名称以“.level”结尾的所有属性都定义了记录器的日志级别。 因此，“foo.level”为名为“foo”的记录器定义了一个日志级别，并且（针对命名层次结构中的任何子级）递归地定义了该日志级别。 日志级别按照它们在属性文件中定义的顺序进行应用。 因此树中的子节点的级别设置应该在其父母的设置之后。 属性名称“.level”可用于设置树的根级别。

LogManager对象上的所有方法都是多线程安全的。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者其他某个线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Constants

String LOGGING_MXBEAN_NAME

Protected constructors

LogManager ()

Public methods

boolean addLogger (Logger logger)

void addPropertyChangeListener (PropertyChangeListener l)

void checkAccess ()

LogManager getLogManager ()

Logger getLogger (String name)

Enumeration<String> getLoggerNames ()

LoggingMXBean getLoggingMXBean ()

String getProperty (String name)

void readConfiguration ()

void readConfiguration (InputStream ins)

void removePropertyChangeListener (PropertyChangeListener l)

void reset ()