public class Level
extends Object implements Serializable
| java.lang.Object | |
| ↳ | java.util.logging.Level |
Level类定义了一组可用于控制日志记录输出的标准日志记录级别。 日志级别对象是有序的，并由有序整数指定。 在给定级别启用日志记录还可以启用所有更高级别的日志记录。
客户通常应该使用预定义的Level常量，例如Level.SEVERE。
水平按降序排列：
第三方可以通过继承Level来定义附加的日志记录级别。 在这种情况下，子类应该注意选择唯一的整数级别值，并通过定义合适的readResolve方法来确保它们跨系列化来维护对象唯一性属性。
Fields |
|
|---|---|
public static final Level |
ALL ALL表示应记录所有消息。 |
public static final Level |
CONFIG CONFIG是静态配置消息的消息级别。 |
public static final Level |
FINE FINE是提供跟踪信息的消息级别。 |
public static final Level |
FINER FINER表示一个相当详细的跟踪消息。 |
public static final Level |
FINEST FINEST表示高度详细的跟踪消息。 |
public static final Level |
INFO INFO是信息消息的消息级别。 |
public static final Level |
OFF OFF是一个特殊级别，可用于关闭日志记录。 |
public static final Level |
SEVERE SEVERE是指示严重故障的消息级别。 |
public static final Level |
WARNING 警告是指示潜在问题的消息级别。 |
Protected constructors |
|
|---|---|
Level(String name, int value) 用给定的整数值创建一个指定的Level。 |
|
Level(String name, int value, String resourceBundleName) 使用给定的整数值和给定的本地化资源名称创建一个命名级别。 |
|
Public methods |
|
|---|---|
boolean |
equals(Object ox) 比较两个对象的值是否相等。 |
String |
getLocalizedName() 返回Level的本地化字符串名称，用于当前默认语言环境。 |
String |
getName() 返回Level的非本地化字符串名称。 |
String |
getResourceBundleName() 返回关卡的本地化资源包名称，如果没有定义本地化包，则返回null。 |
int |
hashCode() 生成一个哈希码。 |
final int |
intValue() 获取此级别的整数值。 |
static Level |
parse(String name) 将级别名称字符串解析为Level。 |
final String |
toString() 返回此Level的字符串表示形式。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
Level CONFIG
CONFIG是静态配置消息的消息级别。
CONFIG消息旨在提供各种静态配置信息，以帮助调试可能与特定配置相关的问题。 例如，CONFIG消息可能包含CPU类型，图形深度，GUI外观等。此级别初始化为700 。
Level FINE
FINE是提供跟踪信息的消息级别。
所有的FINE，FINER和FINEST都用于相对详细的跟踪。 这三个级别的确切含义将因子系统而异，但总的来说，FINEST应该用于最大量的详细输出，FINER用于较不详细的输出，而FINE用于最低量（和最重要）的消息。
一般而言，对于那些对特定子系统没有专门兴趣的开发者而言，应该使用FINE级别来获得广泛的信息。
FINE消息可能包含诸如次要（可恢复）失败之类的事情。 指示潜在性能问题的问题也值得记录为FINE。 该级别初始化为500 。
Level FINER
FINER表示一个相当详细的跟踪消息。 默认情况下，记录进入，返回或抛出异常的调用在这个级别被追踪。 该级别初始化为400 。
Level INFO
INFO是信息消息的消息级别。
通常INFO消息将写入控制台或其等价物。 所以INFO级别只能用于对最终用户和系统管理员有意义的合理重要的消息。 该级别初始化为800 。
Level SEVERE
SEVERE是指示严重故障的消息级别。
一般来说，SEVERE消息应该描述相当重要的事件，这会阻止正常的程序执行。 他们应该对最终用户和系统管理员合理理解。 该级别初始化为1000 。
Level WARNING
警告是指示潜在问题的消息级别。
一般而言，WARNING消息应描述最终用户或系统管理员感兴趣的事件，或者说明潜在问题的事件。 此级别初始化为900 。
Level (String name, int value)
用给定的整数值创建一个指定的Level。
请注意，此构造函数是“受保护的”以允许子类化。 通常，日志记录的客户端应该使用SEVERE或FINEST等常量Level对象之一。 但是，如果客户端需要添加新的日志级别，他们可以继承Level并定义新的常量。
| Parameters | |
|---|---|
name |
String: the name of the Level, for example "SEVERE". |
value |
int: an integer value for the level. |
| Throws | |
|---|---|
NullPointerException |
if the name is null |
Level (String name, int value, String resourceBundleName)
使用给定的整数值和给定的本地化资源名称创建一个命名级别。
| Parameters | |
|---|---|
name |
String: the name of the Level, for example "SEVERE". |
value |
int: an integer value for the level. |
resourceBundleName |
String: name of a resource bundle to use in localizing the given name. If the resourceBundleName is null or an empty string, it is ignored. |
| Throws | |
|---|---|
NullPointerException |
if the name is null |
boolean equals (Object ox)
比较两个对象的值是否相等。
| Parameters | |
|---|---|
ox |
Object: the reference object with which to compare. |
| Returns | |
|---|---|
boolean |
true if and only if the two objects have the same level value. |
String getLocalizedName ()
返回Level的本地化字符串名称，用于当前默认语言环境。
如果没有可用的本地化信息，则返回非本地化名称。
| Returns | |
|---|---|
String |
localized name |
String getResourceBundleName ()
返回关卡的本地化资源包名称，如果没有定义本地化包，则返回null。
| Returns | |
|---|---|
String |
localization resource bundle name |
int hashCode ()
生成一个哈希码。
| Returns | |
|---|---|
int |
a hashcode based on the level value |
int intValue ()
获取此级别的整数值。 此整数值可用于Level对象之间的高效排序比较。
| Returns | |
|---|---|
int |
the integer value for this level. |
Level parse (String name)
将级别名称字符串解析为Level。
参数字符串可能包含级别名称或整数值。
例如：
| Parameters | |
|---|---|
name |
String: string to be parsed |
| Returns | |
|---|---|
Level |
The parsed value. Passing an integer that corresponds to a known name (e.g., 700) will return the associated name (e.g., CONFIG). Passing an integer that does not (e.g., 1) will return a new level name initialized to that value. |
| Throws | |
|---|---|
NullPointerException |
if the name is null |
IllegalArgumentException |
if the value is not valid. Valid values are integers between Integer.MIN_VALUE and Integer.MAX_VALUE, and all known level names. Known names are the levels defined by this class (e.g., FINE, FINER, FINEST), or created by this class with appropriate package access, or new levels defined or created by subclasses. |
String toString ()
返回此Level的字符串表示形式。
| Returns | |
|---|---|
String |
the non-localized name of the Level, for example "INFO". |
Android开发手册