Level (Java Platform SE 8 )

java.lang.Object
- java.util.logging.Level

All Implemented Interfaces:

Serializable
```
public class Level
extends Object
implements Serializable
```
Level类定义了一组可用于控制日志输出的标准日志记录级别。记录级别对象被排序并且由有序整数指定。在给定级别启用日志记录还可以在所有更高级别进行日志记录。
客户端应通常使用预定义的Level常量，如Level.SEVERE。

降序的级别是：
- SEVERE（最高值）
- 警告
- 信息
- 配置
- 精细
- 更精细
- FINEST（最低值）
另外还有一个可以用来关闭日志记录的级别OFF，还有一个可以用来启用所有消息日志记录的级别ALL。
通过对Level进行子类化，第三方有可能定义附加的日志记录级别。在这种情况下，子类应该注意选择唯一的整数级别值，并确保它们通过定义合适的readResolve方法在整个序列化过程中维护Object唯一性。
从以下版本开始：

1.4

另请参见：

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static Level`	`ALL` ALL表示所有消息都应该被记录。
`static Level`	`CONFIG` CONFIG是静态配置消息的消息级别。
`static Level`	`FINE` FINE是提供跟踪信息的消息级别。
`static Level`	`FINER` FINER表示相当详细的跟踪消息。
`static Level`	`FINEST` FINEST表示高度详细的跟踪消息。
`static Level`	`INFO` INFO是信息性消息的消息级别。
`static Level`	`OFF` OFF是可用于关闭日志记录的特殊级别。
`static Level`	`SEVERE` SEVERE是指示严重故障的消息级别。
`static Level`	`WARNING` 警告是指示潜在问题的消息级别。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`Level(String name, int value)` 创建一个具有给定整数值的命名级别。
`protected`	`Level(String name, int value, String resourceBundleName)` 创建一个具有给定整数值和给定的本地化资源名称的命名级别。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`boolean`	`equals(Object ox)` 比较两个对象的值相等。
`String`	`getLocalizedName()` 返回当前默认语言环境的Level的本地化字符串名称。
`String`	`getName()` 返回Level的非本地化字符串名称。
`String`	`getResourceBundleName()` 返回级别的本地化资源包名称，如果未定义本地化包，则返回null。
`int`	`hashCode()` 生成哈希码。
`int`	`intValue()` 获取此级别的整数值。
`static Level`	`parse(String name)` 将级别名称字符串解析为级别。
`String`	`toString()` 返回此级别的字符串表示形式。

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

- 字段详细信息
  - OFF
```
public static final Level OFF
```
    OFF是可用于关闭日志记录的特殊级别。该级别初始化为Integer.MAX_VALUE 。
  - SEVERE
```
public static final Level SEVERE
```
    SEVERE是指示严重故障的消息级别。
    一般来说，SEVERE消息应描述相当重要的事件，哪些会阻止正常的程序执行。对于最终用户和系统管理员来说，它们应该是合理的。该级别初始化为1000 。
  - WARNING
```
public static final Level WARNING
```
    警告是指示潜在问题的消息级别。
    一般来说，警告消息应描述终端用户或系统管理员感兴趣的事件，或者说明潜在的问题。该级别初始化为900 。
  - INFO
```
public static final Level INFO
```
    INFO是信息性消息的消息级别。
    通常，INFO消息将被写入控制台或其等效项。因此，INFO级别只能用于对终端用户和系统管理员有意义的合理重要的消息。该级别初始化为800 。
  - CONFIG
```
public static final Level CONFIG
```
    CONFIG是静态配置消息的消息级别。
    CONFIG消息旨在提供各种静态配置信息，以帮助调试可能与特定配置相关联的问题。例如，CONFIG消息可能包括CPU类型，图形深度，GUI外观等。此级别初始化为700 。
  - FINE
```
public static final Level FINE
```
    FINE是提供跟踪信息的消息级别。
    所有FINE，FINER和FINEST都用于相对详细的追踪。三个级别的确切含义将在子系统之间变化，但是一般来说，FINEST应用于最大体积的详细输出，FINER用于稍微不太详细的输出，FINE用于最低音量（和最重要的）消息。
    
    一般来说，FINE级别应用于对特定子系统没有特殊兴趣的开发人员将会很有趣的信息。
    
    FINE消息可能包括诸如次要（可恢复）故障。表明潜在性能问题的问题也值得记录为FINE。该级别初始化为500 。
  - FINER
```
public static final Level FINER
```
    FINER表示相当详细的跟踪消息。默认情况下，在此级别跟踪进入，返回或抛出异常的日志记录。该级别初始化为400 。
  - FINEST
```
public static final Level FINEST
```
    FINEST表示高度详细的跟踪消息。该级别初始化为300 。
  - ALL
```
public static final Level ALL
```
    ALL表示所有消息都应该被记录。该级别初始化为Integer.MIN_VALUE 。
- 构造方法详细信息
  - Level
```
protected Level(String name,
                int value)
```
    创建一个具有给定整数值的命名级别。
    注意这个构造函数是“protected”来允许子类化。一般来说，日志记录的客户端应该使用一个恒定的Level对象，如SEVERE或FINEST。但是，如果客户端需要添加新的日志记录级别，则它们可能会对Level进行子类化并定义新的常量。
    
    参数
    
    name - 级别的名称，例如“SEVERE”。
    
    value - 级别的整数值。
    
    异常
    
    NullPointerException - 如果名称为空
  - Level
```
protected Level(String name,
                int value,
                String resourceBundleName)
```
    创建一个具有给定整数值和给定的本地化资源名称的命名级别。
    
    参数
    
    name - 级别的名称，例如“SEVERE”。
    
    value - 级别的整数值。
    
    resourceBundleName - 用于本地化给定名称的资源束的名称。如果resourceBundleName为空或空字符串，则会被忽略。
    
    异常
    
    NullPointerException - 如果名称为空
- 方法详细信息
  - getResourceBundleName
```
public String getResourceBundleName()
```
    返回级别的本地化资源包名称，如果未定义本地化包，则返回null。
    
    结果
    
    本地化资源包名称
  - getName
```
public String getName()
```
    返回Level的非本地化字符串名称。
    
    结果
    
    非本地化名称
  - getLocalizedName
```
public String getLocalizedName()
```
    返回当前默认语言环境的Level的本地化字符串名称。
    如果没有可用的本地化信息，则返回非本地化名称。
    
    结果
    
    本地化名称
  - toString
```
public final String toString()
```
    返回此级别的字符串表示形式。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    Level的非本地化名称，例如“INFO”。
  - intValue
```
public final int intValue()
```
    获取此级别的整数值。该整数值可用于Level对象之间的有效排序比较。
    
    结果
    
    该级别的整数值。
  - parse
```
public static Level parse(String name)
                   throws IllegalArgumentException
```
    将级别名称字符串解析为级别。
    参数字符串可以由级别名称或整数值组成。
    
    例如：
    - “严重”
    - “1000”
    参数
    
    name - 要解析的字符串
    
    结果
    
    被解析的价值。传递与已知名称相对应的整数（例如700）将返回相关联的名称（例如， CONFIG ）。传递一个不是（例如，1）的整数将返回一个初始化为该值的新级别名称。
    
    异常
    
    NullPointerException - 如果名称为空
    
    IllegalArgumentException - 如果值无效。有效值为Integer.MIN_VALUE与Integer.MAX_VALUE之间的整数，以及所有已知级别名称。已知的名称是由此类定义的水平（例如， FINE ， FINER ， FINEST ），或由该类适当的包访问，或子类中定义或创建新的水平建立。
  - equals
```
public boolean equals(Object ox)
```
    比较两个对象的值相等。
    
    重写：
    
    equals在 Object
    
    参数
    
    ox - 与之比较的参考对象。
    
    结果
    
    如果且仅当两个对象具有相同的级别值，则为true。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public int hashCode()
```
    生成哈希码。
    
    重写：
    
    hashCode在 Object
    
    结果
    
    基于级别值的哈希码
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

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 Level

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

OFF

SEVERE

WARNING

INFO

CONFIG

FINE

FINER

FINEST

ALL

构造方法详细信息

Level

Level

方法详细信息

getResourceBundleName

getName

getLocalizedName

toString

intValue

parse

equals

hashCode