- java.lang.Object
-
- java.util.logging.Level
-
- All Implemented Interfaces:
-
Serializable
public class Level extends Object implements Serializable
Level类定义了一组可用于控制日志输出的标准日志记录级别。 记录级别对象被排序并且由有序整数指定。 在给定级别启用日志记录还可以在所有更高级别进行日志记录。客户端应通常使用预定义的Level常量,如Level.SEVERE。
降序的级别是:
- SEVERE(最高值)
- 警告
- 信息
- CONFIG
- 精细
- FINER
- FINEST(最低值)
通过对Level进行子类化,第三方有可能定义附加的日志记录级别。 在这种情况下,子类应该注意选择唯一的整数级别值,并确保它们通过定义合适的readResolve方法在整个序列化过程中维护Object唯一性。
- 从以下版本开始:
- 1.4
- 另请参见:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 static LevelALLALL表示所有消息都应该被记录。static LevelCONFIGCONFIG是静态配置消息的消息级别。static LevelFINEFINE是提供跟踪信息的消息级别。static LevelFINERFINER表示相当详细的跟踪消息。static LevelFINESTFINEST表示高度详细的跟踪消息。static LevelINFOINFO是信息性消息的消息级别。static LevelOFFOFF是可用于关闭日志记录的特殊级别。static LevelSEVERESEVERE是指示严重故障的消息级别。static LevelWARNING警告是指示潜在问题的消息级别。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 booleanequals(Object ox)比较两个对象的值相等。StringgetLocalizedName()返回当前默认语言环境的Level的本地化字符串名称。StringgetName()返回Level的非本地化字符串名称。StringgetResourceBundleName()返回级别的本地化资源包名称,如果未定义本地化包,则返回null。inthashCode()生成哈希码。intintValue()获取此级别的整数值。static Levelparse(String name)将级别名称字符串解析为级别。StringtoString()返回此级别的字符串表示形式。
-
-
-
字段详细信息
-
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
警告是指示潜在问题的消息级别。一般来说,警告消息应描述终端用户或系统管理员感兴趣的事件,或者说明潜在的问题。 该级别初始化为
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)
创建一个具有给定整数值的命名级别。注意这个构造函数是“protected”来允许子类化。 一般来说,日志记录的客户端应该使用一个恒定的Level对象,如SEVERE或FINEST。 但是,如果客户端需要添加新的日志记录级别,则它们可能会对Level进行子类化并定义新的常量。
- 参数
-
name- 级别的名称,例如“SEVERE”。 -
value- 级别的整数值。 - 异常
-
NullPointerException- 如果名称为空
-
Level
protected Level(String name, int value, String resourceBundleName)
创建一个具有给定整数值和给定的本地化资源名称的命名级别。- 参数
-
name- 级别的名称,例如“SEVERE”。 -
value- 级别的整数值。 -
resourceBundleName- 用于本地化给定名称的资源束的名称。 如果resourceBundleName为空或空字符串,则会被忽略。 - 异常
-
NullPointerException- 如果名称为空
-
-
方法详细信息
-
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- 如果名称为空 -
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)
-
-