模块  java.logging
软件包  java.util.logging

Class Level

  • 实现的所有接口
    Serializable

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

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

    降序的级别为:

    • 严重(最高价值)
    • 警告
    • 信息
    • CONFIG
    • 精细
    • FINER
    • 最好的(最低价值)
    此外,还有一个可用于关闭日志记录的级别OFF,以及一个可用于启用所有消息记录的级别ALL。

    第三方可以通过继承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
      警告是指示潜在问题的消息级别。
    • 构造方法摘要

      构造方法  
      变量 构造器 描述
      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
        警告是指示潜在问题的消息级别。

        一般而言,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()
        返回此级别的字符串表示形式。
        重写:
        toString Object
        结果
        Level的非本地化名称,例如“INFO”。
      • 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_VALUEInteger.MAX_VALUE之间的整数,以及所有已知的级别名称。 已知的名称是由此类定义的水平(例如, FINEFINERFINEST ),或由该类适当的包访问,或子类中定义或创建新的水平建立。
      • equals

        public boolean equals​(Object ox)
        比较两个对象的值相等性。
        重写:
        equalsObject
        参数
        ox - 要与之比较的引用对象。
        结果
        当且仅当两个对象具有相同的级别值时才返回true。
        另请参见:
        Object.hashCode()HashMap