LogManager (Java Platform SE 8 )

java.lang.Object
- java.util.logging.LogManager

```
public class LogManager
extends Object
```
有一个单一的全球LogManager对象用于维护一组共享状态记录器和日志服务。
这LogManager对象：
- 管理一个Logger对象层次命名空间。所有命名的记录都存储在这个命名空间。
- 管理一组日志记录控件属性。这些都是简单的键-值对，可以通过处理程序和其他日志对象来配置它们自己。
全球LogManager对象可以检索使用getlogmanager() LogManager。LogManager类初始化期间创建的对象不能被改变。

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

LogManager定义了两个可选的系统特性，允许在初始配置控制：
- “java util。测井。配置。班”
- “java util。测井。配置文件”
这两个属性可以在命令行上指定的“java”命令，或系统属性定义了jni_createjavavm。
如果“java util。测井。配置。类”的属性，则属性值作为一个类的名字。给定的类将被加载，一个物体将被实例化，而对象的构造函数负责在初始配置阅读。（该对象可以使用其他系统性能控制配置。）交替配置类可以使用readConfiguration(InputStream)定义LogManager性质。

如果“java util。测井。配置。类”的属性不集，那么“java util。测井。配置文件”属性可用于指定一个属性文件（在java.util.properties格式）。将从该文件读取初始日志记录配置。

如果这些属性没有定义然后LogManager使用其默认配置。默认的配置通常是加载从属性文件”lib/logging.properties”在java的安装目录。

伐木工人和处理程序的性能将有名字的开头的处理程序或记录点分隔的名称。

全局日志记录属性可能包括：
- 属性“处理程序”。这定义了一个空格或逗号分隔的处理程序类加载并登记在根记录器句柄类名列表（日志命名为“”）。每个类的名称必须是一个有一个默认构造函数的处理程序类。请注意，这些程序可能会创建懒洋洋地，当他们是第一次使用。
- 房地产“ <日志> 。犬”。这定义了一个空格或逗号分隔的犬类加载和登记为操作者指定记录器类名称列表。每个类的名称必须是一个有一个默认构造函数的处理程序类。请注意，这些程序可能会创建懒洋洋地，当他们是第一次使用。
- “ <属性> useparenthandlers记录器。”。这定义了一个布尔值。默认情况下，每一个记录电话除了处理测井信息本身，其母，这往往导致以及根记录器信息处理。当此属性设置为false处理程序需要配置这个记录器，否则没有测井信息传递。
- 属性“配置”。此属性的目的是允许运行任意配置代码。属性定义了一个空格或逗号分隔的类名称的列表。将为每个命名类创建一个新的实例。每个类的默认构造函数可以执行任意代码的更新日志的配置，如设置日志级别，添加处理程序，添加过滤器，等。
注意所有的类加载时首先搜索LogManager配置系统类路径之前，任何用户类路径。这包括LogManager类，任何配置的类，和任何处理程序类。

伐木工人被组织成一个命名层次结构的基础上用点分隔的名字。因此，“ABC”是孩子的“内压”，但“a.b1”和a.b2”同行。

所有属性的名称结尾。”被假定为记录器定义日志级别。因此“foo”定义了一个日志级别的记录称为“foo”（递归）任何在命名层次的孩子。在属性文件中定义的顺序中应用日志级别。因此，在树中的子节点的级别设置应为他们的父母。属性名称“级别”可用于设置树的根的级别。

对LogManager对象所有的方法都是线程安全的。
从以下版本开始：

一点四

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平台模块化的一个重大障碍。这种方法将在未来的版本中删除。全球`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平台模块化的一个重大障碍。这种方法将在未来的版本中删除。全球`LogManager`可以检测变化的日志配置的`readConfiguration`凌驾性的方法。
`void`	`reset()` 重置日志记录配置。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LOGGING_MXBEAN_NAME
```
public static final String LOGGING_MXBEAN_NAME
```
    对测井设备管理界面的 ObjectName字符串表示形式。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    PlatformLoggingMXBean， LoggingMXBean， Constant Field Values
- Constructor Detail
  - 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平台模块化的一个重大障碍。这种方法将在未来的版本中删除。全球LogManager可以检测变化的日志配置的readConfiguration凌驾性的方法。
    
    添加当日志记录属性重新读取时要调用的事件侦听器。添加同一事件侦听器的多个实例，结果在属性事件侦听器表中的多个条目中。
    警告：这种方法是省略这类在java SE，不包括java.beans软件包的所有子集简介。
    
    参数
    
    l事件监听器
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
    
    NullPointerException -如果propertychangelistener是空的。
  - removePropertyChangeListener
```
@Deprecated
public void removePropertyChangeListener(PropertyChangeListener l)
                                              throws SecurityException
```
    过时的。在PropertyChangeListener依赖创造未来的java平台模块化的一个重大障碍。这种方法将在未来的版本中删除。全球LogManager可以检测变化的日志配置的readConfiguration凌驾性的方法。
    
    移除属性更改事件的事件侦听器。如果同一个监听器实例被添加到监听表通过 addPropertyChangeListener多次调用，然后调用 removePropertyChangeListener同等数量要从表中删除所有听众，听众的实例。
    如果没有找到给定的侦听器，则将返回。
    
    警告：这种方法是省略这类在java SE，不包括java.beans软件包的所有子集简介。
    
    参数
    
    l事件侦听器（可以为空）
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
  - addLogger
```
public boolean addLogger(Logger logger)
```
    添加一个名为记录器。这不，返回false，如果具有相同名称的记录已经注册。
    记录器的工厂方法调用这个方法来登记每个新创建的日志。
    
    应用程序应该自己参考的记录器对象避免它被垃圾收集保留。LogManager可能只保留一个弱引用。
    
    参数
    
    logger -新记录。
    
    结果
    
    如果参数记录器注册成功真，假如果一个记录器的名称已经存在。
    
    异常
    
    NullPointerException如果日志名称为空。
  - getLogger
```
public Logger getLogger(String name)
```
    找到一个名叫记录方法。
    请注意，由于不受信任的代码可以创建任意名称记录器该方法不依赖于寻找安全敏感的日志记录器。也要注意与字符串相关的name记录器可以被收集在任何时候如果没有强有力的参考日志垃圾重要。该方法的调用方必须检查返回值是否为空为妥善处理的情况下被垃圾收集的日志。
    
    参数
    
    name -日志名称
    
    结果
    
    匹配记录或空如果没有发现
  - getLoggerNames
```
public Enumeration<String> getLoggerNames()
```
    把已知的日志名称的枚举。
    注：记录仪可以动态添加新的类被加载。这种方法只报道，目前注册的记录器。这是要注意，这种方法只返回一个记录的名字很重要，没有一个强有力的参考日志本身。返回的字符串并没有阻止记录器被垃圾收集。特别是，如果返回的名称传递给LogManager.getLogger()，那么调用者必须检查返回值为空LogManager.getLogger()妥善处理的情况下，记录一直以来在它的名字是由该方法返回的时间收集的垃圾。
    
    结果
    
    日志记录名称字符串枚举
  - readConfiguration
```
public void readConfiguration()
                       throws IOException,
                              SecurityException
```
    重新初始化日志属性和重读日志配置。
    相同的规则被用于定位在启动时使用的配置属性。因此通常日志属性将从在启动时使用的相同的文件重新读取。
    
    在新的配置文件的任何日志级别定义将使用记录器。setlevel()，如果目标记录存在。
    
    一个PropertyChangeEvent后会读取发射性能。
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
    
    如果有问题 IOException IO读取配置。
  - reset
```
public void reset()
           throws SecurityException
```
    重置日志记录配置。
    所有命名的记录器，复位操作移除并关闭所有程序和（除了根记录器）设置为零的水平。根记录器的级别设置为Level.INFO。
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
  - readConfiguration
```
public void readConfiguration(InputStream ins)
                       throws IOException,
                              SecurityException
```
    重新初始化日志属性和重读日志配置从给定的数据流，这应该是在java.util.properties格式。一个PropertyChangeEvent后会读取发射性能。
    在新的配置文件的任何日志级别定义将使用记录器。setlevel()，如果目标记录存在。
    
    参数
    
    ins -流读取性能
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
    
    IOException -如果有阅读从流问题。
  - getProperty
```
public String getProperty(String name)
```
    获取日志记录属性的值。如果找不到属性，则方法返回空值。
    
    参数
    
    name属性名称
    
    结果
    
    属性值
  - checkAccess
```
public void checkAccess()
                 throws SecurityException
```
    请检查当前上下文是否被信任以修改日志记录配置。这就要求loggingpermission（“控制”）。
    如果检查失败我们抛出SecurityException，否则我们回归正常。
    
    异常
    
    SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。
  - getLoggingMXBean
```
public static LoggingMXBean getLoggingMXBean()
```
    返回 LoggingMXBean管理记录器。另一种方式是通过 PlatformLoggingMXBean管理记录器接口，可以通过电话：
```
platformloggingmxbean测井= ManagementFactory.getPlatformMXBean（platformloggingmxbean。类）；
```
    结果
    
    一个 LoggingMXBean对象。
    
    从以下版本开始：
    
    一点五
    
    另请参见：
    
    PlatformLoggingMXBean

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class LogManager

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

LOGGING_MXBEAN_NAME

Constructor Detail

LogManager

方法详细信息

getLogManager

addPropertyChangeListener

removePropertyChangeListener

addLogger

getLogger

getLoggerNames

readConfiguration

reset

readConfiguration

getProperty

checkAccess

getLoggingMXBean