- java.lang.Object
-
- java.util.logging.Level
-
- 实现的所有接口
-
Serializable
public class Level extends Object implements Serializable
Level类定义了一组标准日志记录级别,可用于控制日志记录输出。 日志级别对象是有序的,并由有序整数指定。 在给定级别启用日志记录还可以在所有更高级别进行日志记录。客户端通常应使用预定义的Level常量,如Level.SEVERE。
降序的级别为:
- 严重(最高价值)
- 警告
- 信息
- CONFIG
- 精细
- FINER
- 最好的(最低价值)
第三方可以通过继承Level来定义其他日志记录级别。 在这种情况下,子类应注意选择唯一的整数级别值,并确保它们通过定义合适的readResolve方法来跨序列化维护Object唯一性属性。
- 从以下版本开始:
- 1.4
- 另请参见:
- Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 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
警告是指示潜在问题的消息级别。
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 boolean
equals(Object ox)
比较两个对象的值相等性。String
getLocalizedName()
返回当前默认语言环境的Level的本地化字符串名称。String
getName()
返回Level的非本地化字符串名称。String
getResourceBundleName()
返回级别的本地化资源包名称,如果未定义本地化包,则返回null。int
hashCode()
生成哈希码。int
intValue()
获取此级别的整数值。static Level
parse(String name)
将级别名称字符串解析为级别。String
toString()
返回此级别的字符串表示形式。
-
-
-
字段详细信息
-
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消息应描述最终用户或系统管理员感兴趣的事件,或表明潜在问题的事件。 此级别初始化为
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)
使用给定的整数值创建命名级别。请注意,此构造函数是“受保护的”以允许子类化。 通常,日志记录的客户端应使用其中一个常量Level对象,例如SEVERE或FINEST。 但是,如果客户端需要添加新的日志记录级别,则可以将Level子类化并定义新常量。
- 参数
-
name
- 级别的名称,例如“SEVERE”。 -
value
- 级别的整数值。 - 异常
-
NullPointerException
- 如果名称为null
-
Level
protected Level(String name, int value, String resourceBundleName)
使用给定的整数值和给定的本地化资源名称创建命名级别。- 参数
-
name
- 级别的名称,例如“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()
返回此级别的字符串表示形式。
-
intValue
public final int intValue()
获取此级别的整数值。 此整数值可用于Level对象之间的有效排序比较。- 结果
- 此级别的整数值。
-
parse
public static Level parse(String name) throws IllegalArgumentException
将级别名称字符串解析为级别。参数字符串可以包含级别名称或整数值。
例如:
- “严重”
- “1000”
- 参数
-
name
- 要解析的字符串 - 结果
-
解析后的值。
传递对应于已知名称(例如,700)的整数将返回关联的名称(例如,
CONFIG
)。 传递不是(例如,1)的整数将返回初始化为该值的新级别名称。 - 异常
-
NullPointerException
- 如果名称为null -
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)
-
-