模块 java.logging
包 java.util.logging

类 Level

java.lang.Object
java.util.logging.Level
所有已实现的接口：
Serializable
public class Level extends Object implements Serializable
Level 类定义了一组可用于控制日志输出的标准日志记录级别。日志级别对象是有序的，并由有序整数指定。在给定级别启用日志记录也会在所有更高级别启用日志记录。

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

降序排列的级别是：

  • 严重（最高值）
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST（最低值）
此外，还有一个级别 OFF 可用于关闭日志记录，以及一个级别 ALL 可用于启用所有消息的日志记录。

第三方可以通过继承 Level 来定义额外的日志记录级别。在这种情况下，子类应注意选择唯一的整数级别值，并通过定义合适的 readResolve 方法确保它们在整个序列化过程中保持对象的唯一性属性。

自从：
1.4
参见：

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final Level
    ALL
    ALL 指示应记录所有消息。
    static final Level
    CONFIG
    CONFIG 是静态配置消息的消息级别。
    static final Level
    FINE
    FINE 是提供跟踪信息的消息级别。
    static final Level
    FINER
    FINER 指示相当详细的跟踪消息。
    static final Level
    FINEST
    FINEST 指示非常详细的跟踪消息。
    static final Level
    INFO
    INFO 是信息消息的消息级别。
    static final Level
    OFF
    OFF 是一个特殊级别，可用于关闭日志记录。
    static final Level
    SEVERE
    SEVERE 是指示严重故障的消息级别。
    static final Level
    WARNING
    WARNING 是指示潜在问题的消息级别。

  • 构造方法总结

    构造方法
    修饰符
    构造方法
    描述
    protected
    Level(String name, int value)
    创建具有给定整数值的命名级别。
    protected
    Level(String name, int value, String resourceBundleName)
    使用给定的整数值和给定的本地化资源名称创建命名级别。

  • 方法总结

    修饰符和类型
    方法
    描述
    boolean
    equals(Object ox)
    比较两个对象的值是否相等。
    String
    getLocalizedName()
    对于当前默认locale，返回级别的本地化字符串名称。
    String
    getName()
    返回关卡的非本地化字符串名称。
    String
    getResourceBundleName()
    返回关卡的本地化资源包名称，如果未定义本地化包，则返回 null。
    int
    hashCode()
    生成哈希码。
    final int
    intValue()
    获取此级别的整数值。
    static Level
    parse(String name)
    将关卡名称字符串解析为关卡。
    final 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 是指示潜在问题的消息级别。

      一般来说，警告消息应该描述最终用户或系统管理员会感兴趣的事件，或者指示潜在问题的事件。此级别初始化为 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)
      创建具有给定整数值的命名级别。

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

      参数：
      name - 级别的名称，例如“SEVERE”。
      value - 级别的整数值。
      抛出：
      NullPointerException - 如果名称为空

    • Level

      protected Level(String  name, int value, String  resourceBundleName)
      使用给定的整数值和给定的本地化资源名称创建命名级别。
      参数：
      name - 级别的名称，例如“SEVERE”。
      value - 级别的整数值。
      resourceBundleName - 用于本地化给定名称的资源包的名称。如果 resourceBundleName 为 null 或空字符串，它将被忽略。
      抛出：
      NullPointerException - 如果名称为空

  • 方法详情

    • getResourceBundleName

      public String  getResourceBundleName()
      返回关卡的本地化资源包名称，如果未定义本地化包，则返回 null。
      返回：
      本地化资源包名称

    • getName

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

    • getLocalizedName

      public String  getLocalizedName()
      对于当前默认locale，返回级别的本地化字符串名称。

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

      返回：
      本地化名称

    • toString

      public final String  toString()
      返回此级别的字符串表示形式。
      重写：
      toString 在类 Object 中
      返回：
      级别的非本地化名称，例如“INFO”。

    • intValue

      public final int intValue()
      获取此级别的整数值。此整数值可用于 Level 对象之间的高效排序比较。
      返回：
      此级别的整数值。

    • parse

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

      参数字符串可以包含级别名称或整数值。

      例如：

      • "SEVERE"
      • "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 - 要比较的参考对象。
      返回：
      当且仅当两个对象具有相同的级别值时才为真。
      参见：

    • hashCode

      public int hashCode()
      生成哈希码。
      重写：
      hashCode 在类 Object 中
      返回：
      基于级别值的哈希码
      参见：