©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.util.logging.Level
public class Level
Level 类定义了一组可用来控制日志输出的标准日志级别。日志 Level 对象是有序的,并且是通过有序的整数来指定。在给定的级别上启用日志记录也就启用了所有较高级别的日志记录。
客户机一般应该使用预定义的 Level 常量(如 Level.SEVERE)。
各级别按降序排列如下:
第三方可通过子类化 Level 来定义其他的日志级别。在这种情况下,子类应该注意选择唯一的整数级别值,并确保通过定义合适的 readResolve 方法,维护整个序列化过程的 Object 单值属性。
字段摘要 | |
---|---|
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
WARNING 是指示潜在问题的消息级别。 |
构造方法摘要 | |
---|---|
protected |
Level(String name,
int value)
使用给定的整数值创建一个指定的 Level。 |
protected |
Level(String name,
int value,
String resourceBundleName)
使用给定的整数值和给定的本地化资源名称创建一个指定的 Level。 |
方法摘要 | |
---|---|
boolean |
equals(Object ox)
比较两个对象值的相等性。 |
String |
getLocalizedName()
返回当前默认语言环境的 Level 的本地化字符串名称。 |
String |
getName()
返回 Level 的非本地化字符串名称。 |
String |
getResourceBundleName()
返回级别的本地化资源包名称;如果没有定义本地化包,则返回 null。 |
int |
hashCode()
生成哈希码。 |
int |
intValue()
获得此级别的整数值。 |
static Level |
parse(String name)
将级别名称字符串解析成 Level。 |
String |
toString()
返回该对象的字符串表示。 |
从类 java.lang.Object 继承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final Level OFF
Integer.MAX_VALUE
。
public static final Level SEVERE
通常,SEVERE 消息应该描述相当重要的事件,这些事件会阻止正常程序的执行。它们对于最终用户和系统管理员来说应该是很容易理解的。此级别初始化为 1000
。
public static final Level WARNING
通常,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.MAX_VALUE
。
构造方法详细信息 |
---|
protected Level(String name, int value)
注意,此构造方法是“受保护”的,允许子类化。通常,日志记录的客户机应该使用固定的 Level 对象之一,如 SEVERE 或 FINEST。但是,如果客户机需要添加新的日志级别,则它们可能子类化 Level,并定义新的常量。
name
- Level 的名称,如 "SEVERE"。value
- 级别的整数值。
NullPointerException
- 如果名称为 null。protected Level(String name, int value, String resourceBundleName)
name
- Level 的名称,如 "SEVERE"。value
- 级别的整数值。resourceBundleName
- 本地化给定的名称时使用的资源包名称。如果 resourceBundleName 为 null 或是一个空字符串,则将其忽略。
NullPointerException
- 如果名称为 null。方法详细信息 |
---|
public String getResourceBundleName()
public String getName()
public String getLocalizedName()
如果没有可用的本地化信息,则返回非本地化名称。
public final String toString()
Object
复制的描述toString
方法会返回一个“以文本方式表示”此对象的字符串。结果应是一个简明但易于读懂的信息表达式。建议所有子类都重写此方法。
Object
类的 toString
方法返回一个字符串,该字符串由类名(对象是该类的一个实例)、at 标记符“@
”和此对象哈希码的无符号十六进制表示组成。换句话说,该方法返回一个字符串,它的值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Object
中的 toString
public final int intValue()
public static Level parse(String name) throws IllegalArgumentException
参数字符串可能由级别名称或整数值组成。
例如:
name
- 要解析的字符串。
CONFIG
)。传递不对应已知名称的整数(如 1)将返回一个初始化为该值的新级别名称。
NullPointerException
- 如果名称为 null。
IllegalArgumentException
- 如果该值是无效的。有效值是 Integer.MIN_VALUE
和 Integer.MAX_VALUE
之间的整数值,以及所有已知的级别名称。已知的名称是由此类(也就是 FINE
、FINER
、FINEST
)所定义的级别,或者由此类使用适当的包访问所创建的级别,或者是由子类定义或创建的新级别。public boolean equals(Object ox)
Object
中的 equals
ox
- 要与之比较的引用对象。
Object.hashCode()
,
Hashtable
public int hashCode()
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。