compact1, compact2, compact3

java.util.logging

Class LogManager

java.lang.Object

java.util.logging.LogManager

public class LogManager
extends Object

有一个全局LogManager对象用于维护关于日志记录器和日志服务的一组共享状态。

这个LogManager对象：

• 管理Logger对象的分层命名空间。 所有命名的记录器都存储在此命名空间中。
• 管理一组日志控制属性。 这些是简单的键值对，可以由处理程序和其他日志记录对象来配置自己。

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

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

LogManager定义了两个可选的系统属性，可以控制初始配置：

• “java.util.logging.config.class”
• “java.util.logging.config.file”

这两个属性可以在命令行中指定到“java”命令，或者作为传递给JNI_CreateJavaVM的系统属性定义。

如果设置了“java.util.logging.config.class”属性，那么属性值将被视为一个类名。 给定的类将被加载，一个对象将被实例化，该对象的构造函数负责在初始配置中进行读取。 （该对象可以使用其他系统属性来控制其配置。）备用配置类可以使用readConfiguration(InputStream)来定义LogManager中的属性。

如果未设置“java.util.logging.config.class”属性，则可以使用“java.util.logging.config.file”系统属性来指定属性文件（以java.util.Properties格式）。 从该文件读取初始记录配置。

如果这两个属性都未定义，则LogManager将使用其默认配置。 默认配置通常从Java安装目录中的属性文件“ lib/logging.properties ”加载。

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

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

• 一个财产“处理者”。 这定义了一个空格或逗号分隔的类名列表，用于处理程序类，以加载和注册为根记录器（名为“”的记录器）上的处理程序。 每个类名必须是具有默认构造函数的Handler类。 请注意，这些处理程序可能会在第一次使用时被懒惰地创建。
• 属性“<logger> .handlers”。 这定义了处理程序类的空格或逗号分隔的类名列表，以加载和注册为指定的记录器的处理程序。 每个类名必须是具有默认构造函数的Handler类。 请注意，这些处理程序可能会在第一次使用时被懒惰地创建。
• 属性“<logger> .useParentHandlers”。 这定义了一个布尔值。 默认情况下，每个记录器除了处理日志消息本身之外都调用其父进程，这通常导致消息由根记录器处理。 将此属性设置为false时，需要为此记录器配置处理程序，否则不会传送日志记录消息。
• 属性“config”。 此属性旨在允许运行任意配置代码。 该属性定义了一个空格或逗号分隔的类名列表。 将为每个已命名的类创建一个新的实例。 每个类的默认构造函数可以执行任意代码来更新日志记录配置，例如设置记录器级别，添加处理程序，添加过滤器等。

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

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

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

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

从以下版本开始：

1.4

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOGGING_MXBEAN_NAME 该字符串表示ObjectName为日志工具的管理界面。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	LogManager() 受保护的构造函数。

方法摘要

Modifier and Type	Method and Description
boolean	addLogger(Logger logger) 添加一个命名记录器。
void	addPropertyChangeListener(PropertyChangeListener l) 已弃用 对PropertyChangeListener的依赖性对Java平台的未来PropertyChangeListener造成了重大障碍。 此方法将在以后的版本中删除。 全局LogManager可以通过覆盖readConfiguration方法来检测日志记录配置的更改。
void	checkAccess() 检查当前上下文是否受信任以修改日志记录配置。
Logger	getLogger(String name) 找到一个命名记录器的方法。
Enumeration<String>	getLoggerNames() 获取已知记录器名称的枚举。
static LoggingMXBean	getLoggingMXBean() 退货 LoggingMXBean用于管理记录器。
static LogManager	getLogManager() 返回全局LogManager对象。
String	getProperty(String name) 获取日志记录属性的值。
void	readConfiguration() 重新初始化日志记录属性并重新读取日志配置。
void	readConfiguration(InputStream ins) 重新初始化日志记录属性，并从给定流重新读取日志记录配置，这些流应该是java.util.Properties格式。
void	removePropertyChangeListener(PropertyChangeListener l) 已弃用 对PropertyChangeListener的依赖性对未来Java平台的PropertyChangeListener造成了重大障碍。 此方法将在以后的版本中删除。 全局LogManager可以通过覆盖readConfiguration方法检测日志记录配置的更改。
void	reset() 重置日志配置。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

LOGGING_MXBEAN_NAME

public static final String LOGGING_MXBEAN_NAME

该字符串表示ObjectName为日志工具的管理界面。

从以下版本开始：

1.5

另请参见：

PlatformLoggingMXBean ， LoggingMXBean ， Constant Field Values

构造方法详细信息

LogManager

protected LogManager()

受保护的构造函数。 这是受保护的，因此容器应用程序（如J2EE容器）可以对象进行子类化。 它是非公开的，因为只有一个LogManager对象，其值通过调用LogManager.getLogManager来检索。

方法详细信息

getLogManager

public static LogManager getLogManager()

返回全局LogManager对象。

结果

全局LogManager对象

addPropertyChangeListener

@Deprecated
public void addPropertyChangeListener(PropertyChangeListener l)
                                           throws SecurityException

已弃用 对PropertyChangeListener的依赖性对未来Java平台的PropertyChangeListener造成了重大障碍。 此方法将在以后的版本中删除。 全局LogManager可以通过覆盖readConfiguration方法来检测日志记录配置的更改。

添加在重新读取日志记录属性时调用的事件侦听器。 添加同一事件侦听器的多个实例会导致属性事件侦听器表中的多个条目。

警告：在Java SE的所有不包括java.beans程序包的子集配置文件中，此类将省略此方法。

参数

l - 事件侦听器

异常

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

NullPointerException - 如果PropertyChangeListener为空。

removePropertyChangeListener

@Deprecated
public void removePropertyChangeListener(PropertyChangeListener l)
                                              throws SecurityException

已弃用 对PropertyChangeListener的依赖性对未来Java平台的PropertyChangeListener造成了重大障碍。 此方法将在以后的版本中删除。 全局LogManager可以通过覆盖readConfiguration方法来检测日志记录配置的更改。

删除属性更改事件的事件侦听器。 如果相同的侦听器实例已经通过的多个调用添加到听者表addPropertyChangeListener ，则同等数量removePropertyChangeListener需要调用以从听者表中删除该侦听器的所有实例。

如果找不到给定的监听器，则会静默地返回。

警告：在Java SE的所有不包括java.beans包的子集配置文件中，此类将省略此方法。

参数

l - 事件侦听器（可以为null）

异常

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

addLogger

public boolean addLogger(Logger logger)

添加一个命名记录器。 如果已经注册了具有相同名称的记录器，则此操作不会返回false。

记录器工厂方法调用此方法来注册每个新创建的记录器。

应用程序应该保留自己对Logger对象的引用，以避免它被垃圾回收。 LogManager可能只保留弱引用。

参数

logger - 新的记录器。

结果

如果参数记录器已成功注册，则为true，如果该名称的记录器已存在则为false。

异常

NullPointerException - 如果记录器名称为空。

getLogger

public Logger getLogger(String name)

找到一个命名记录器的方法。

请注意，由于不可信代码可能会创建具有任意名称的日志记录器，因此不应依赖此方法来查找日志记录器以进行安全敏感日志记录。 同样重要的是注意，如果没有强大的引用记录器，与字符串name的记录器可能随时被垃圾回收。 该方法的调用者必须检查null的返回值才能正确处理Logger已被垃圾回收的情况。

参数

name - 记录器的名称

结果

匹配记录器，如果没有找到，则返回null

getLoggerNames

public Enumeration<String> getLoggerNames()

获取已知记录器名称的枚举。

注意：加载新类时，可以动态添加记录器。 此方法仅报告当前注册的记录器。 同样重要的是要注意，此方法只返回Logger的名称，而不是对Logger本身的强引用。 返回的String不会阻止Logger被垃圾回收。 特别地，如果返回的名称传递给LogManager.getLogger() ，则调用者必须从LogManager.getLogger()检查返回值为null，以正确处理由于此方法返回其名称后，Logger已被垃圾回收的情况。

结果

记录器名称字符串的枚举

readConfiguration

public void readConfiguration()
                       throws IOException,
                              SecurityException

重新初始化日志记录属性并重新读取日志配置。

使用相同的规则来定位启动时使用的配置属性。 所以通常记录属性将从启动时使用的同一文件重新读取。

如果目标记录器存在，则新配置文件中的任何日志级别定义将使用Logger.setLevel（）应用。

属性读取后，PropertyChangeEvent将被触发。

异常

SecurityException - 如果安全管理器存在，并且呼叫者没有LoggingPermission（“控制”）。

IOException - 如果读取配置有IO问题。

reset

public void reset()
           throws SecurityException

重置日志配置。

对于所有命名的记录器，重置操作将删除并关闭所有处理程序，除了根记录器之外，将级别设置为空。 根记录器的级别设置为Level.INFO。

异常

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

readConfiguration

public void readConfiguration(InputStream ins)
                       throws IOException,
                              SecurityException

重新初始化日志记录属性，并从给定流重新读取日志记录配置，这些流应该是java.util.Properties格式。 属性读取后，PropertyChangeEvent将被触发。

如果目标记录器存在，则新配置文件中的任何日志级别定义将使用Logger.setLevel（）应用。

参数

ins - 从中读取属性的流

异常

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

IOException - 如果从流读取有问题。

getProperty

public String getProperty(String name)

获取日志记录属性的值。 如果找不到该属性，该方法返回null。

参数

name - 属性名称

结果

属性值

checkAccess

public void checkAccess()
                 throws SecurityException

检查当前上下文是否受信任以修改日志记录配置。 这需要LoggingPermission（“control”）。

如果检查失败，我们抛出一个SecurityException，否则返回正常。

异常

SecurityException - 如果安全管理器存在，并且呼叫者没有LoggingPermission（“控制”）。

getLoggingMXBean

public static LoggingMXBean getLoggingMXBean()

退货LoggingMXBean用于管理记录器。 管理记录器的另一种方法是通过PlatformLoggingMXBean接口，可以通过调用：

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

结果

一个LoggingMXBean对象。

从以下版本开始：

1.5

另请参见：

PlatformLoggingMXBean