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