Module  java.logging
软件包  java.util.logging

Class Level

  • All Implemented Interfaces:
    Serializable


    public class Level
    extends Object
    implements Serializable
    Level类定义了一组可用于控制日志输出的标准日志记录级别。 记录级别对象被排序并且由有序整数指定。 在给定级别启用日志记录还可以在所有更高级别进行日志记录。

    客户端应通常使用预定义的Level常量,如Level.SEVERE。

    降序的级别是:

    • SEVERE(最高值)
    • 警告
    • 信息
    • CONFIG
    • 精细
    • FINER
    • FINEST(最低值)
    另外还有一个可以用来关闭日志记录的级别OFF,还有一个可以用来启用所有消息日志记录的级别ALL。

    通过对Level进行子类化,第三方有可能定义附加的日志记录级别。 在这种情况下,子类应该注意选择唯一的整数级别值,并确保它们通过定义合适的readResolve方法在整个序列化过程中维护Object唯一性。

    从以下版本开始:
    1.4
    另请参见:
    Serialized Form
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      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 描述
      protected Level​(String name, int value)
      创建一个具有给定整数值的命名级别。
      protected Level​(String name, int value, String resourceBundleName)
      创建一个具有给定整数值和给定的本地化资源名称的命名级别。
    • 字段详细信息

      • 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​()
        返回此级别的字符串表示形式。
        重写:
        toStringObject
        结果
        Level的非本地化名称,例如“INFO”。
      • intValue

        public final int intValue​()
        获取此级别的整数值。 该整数值可用于Level对象之间的有效排序比较。
        结果
        该级别的整数值。
      • parse

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

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

        例如:

        • “严重”
        • “1000”
        参数
        name - 要解析的字符串
        结果
        被解析的价值。 传递一个与已知名称相对应的整数(例如700)将返回相关联的名称(例如, CONFIG )。 传递一个不是(例如,1)的整数将返回一个初始化为该值的新级别名称。
        异常
        NullPointerException - 如果名称为空
        IllegalArgumentException - 如果该值无效。 有效值为Integer.MIN_VALUEInteger.MAX_VALUE之间的整数,以及所有已知级别名称。 已知的名称是由此类定义的水平(例如, FINEFINERFINEST ),或由该类适当的包访问,或子类中定义或创建新的水平建立。
      • equals

        public boolean equals​(Object ox)
        比较两个对象的值相等。
        重写:
        equalsObject
        参数
        ox - 与之比较的参考对象。
        结果
        如果且仅当两个对象具有相同的级别值,则为true。
        另请参见:
        Object.hashCode()HashMap