JavaTM Platform
Standard Ed. 6

java.util.logging
类 Level

java.lang.Object
  继承者 java.util.logging.Level
所有已实现的接口:
Serializable

public class Level
extends Object
implements Serializable

Level 类定义了一组可用来控制日志输出的标准日志级别。日志 Level 对象是有序的,并且是通过有序的整数来指定。在给定的级别上启用日志记录也就启用了所有较高级别的日志记录。

客户机一般应该使用预定义的 Level 常量(如 Level.SEVERE)。

各级别按降序排列如下:

此外,还有一个级别 OFF,可用来关闭日志记录,使用级别 ALL 启用所有消息的日志记录。

第三方可通过子类化 Level 来定义其他的日志级别。在这种情况下,子类应该注意选择唯一的整数级别值,并确保通过定义合适的 readResolve 方法,维护整个序列化过程的 Object 单值属性。

从以下版本开始:
1.4
另请参见:
序列化表格

字段摘要
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
 

字段详细信息

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
WARNING 是指示潜在问题的消息级别。

通常,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.MAX_VALUE

构造方法详细信息

Level

protected Level(String name,
                int value)
使用给定的整数值创建一个指定的 Level。

注意,此构造方法是“受保护”的,允许子类化。通常,日志记录的客户机应该使用固定的 Level 对象之一,如 SEVERE 或 FINEST。但是,如果客户机需要添加新的日志级别,则它们可能子类化 Level,并定义新的常量。

参数:
name - Level 的名称,如 "SEVERE"。
value - 级别的整数值。
抛出:
NullPointerException - 如果名称为 null。

Level

protected Level(String name,
                int value,
                String resourceBundleName)
使用给定的整数值和给定的本地化资源名称创建一个指定的 Level。

参数:
name - Level 的名称,如 "SEVERE"。
value - 级别的整数值。
resourceBundleName - 本地化给定的名称时使用的资源包名称。如果 resourceBundleName 为 null 或是一个空字符串,则将其忽略。
抛出:
NullPointerException - 如果名称为 null。
方法详细信息

getResourceBundleName

public String getResourceBundleName()
返回级别的本地化资源包名称;如果没有定义本地化包,则返回 null。

返回:
本地化资源包的名称。

getName

public String getName()
返回 Level 的非本地化字符串名称。

返回:
非本地化名称。

getLocalizedName

public String getLocalizedName()
返回当前默认语言环境的 Level 的本地化字符串名称。

如果没有可用的本地化信息,则返回非本地化名称。

返回:
本地化名称。

toString

public final String toString()
从类 Object 复制的描述
返回该对象的字符串表示。通常,toString 方法会返回一个“以文本方式表示”此对象的字符串。结果应是一个简明但易于读懂的信息表达式。建议所有子类都重写此方法。

Object 类的 toString 方法返回一个字符串,该字符串由类名(对象是该类的一个实例)、at 标记符“@”和此对象哈希码的无符号十六进制表示组成。换句话说,该方法返回一个字符串,它的值等于:

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

覆盖:
Object 中的 toString
返回:
返回 Level 的非本地化字符串名称,如 "INFO"。

intValue

public final int intValue()
获得此级别的整数值。此整数值可以用于在 Level 对象间进行有效的排序比较。

返回:
此级别的整数值。

parse

public static Level parse(String name)
                   throws IllegalArgumentException
将级别名称字符串解析成 Level。

参数字符串可能由级别名称或整数值组成。

例如:

参数:
name - 要解析的字符串。
返回:
解析的值。传递对应于已知名称的整数(如 700)将返回相关的名称(如 CONFIG)。传递不对应已知名称的整数(如 1)将返回一个初始化为该值的新级别名称。
抛出:
NullPointerException - 如果名称为 null。
IllegalArgumentException - 如果该值是无效的。有效值是 Integer.MIN_VALUEInteger.MAX_VALUE 之间的整数值,以及所有已知的级别名称。已知的名称是由此类(也就是 FINEFINERFINEST)所定义的级别,或者由此类使用适当的包访问所创建的级别,或者是由子类定义或创建的新级别。

equals

public boolean equals(Object ox)
比较两个对象值的相等性。

覆盖:
Object 中的 equals
参数:
ox - 要与之比较的引用对象。
返回:
当且仅当两个对象的级别值相同时才返回 true。
另请参见:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
生成哈希码。

覆盖:
Object 中的 hashCode
返回:
级别值的哈希码。
另请参见:
Object.equals(java.lang.Object), Hashtable

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策