Module java.logging
Package java.util.logging

Class Level

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

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

按降序排列的级别为:

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

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

自 JDK 版本:
1.4
参见:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    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是指示潜在问题的消息级别。

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    Level(String name, int value)
    使用给定的整数值创建一个命名的Level。
    protected
    Level(String name, int value, String resourceBundleName)
    使用给定的整数值和给定的本地化资源名称创建一个命名的Level。

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object ox)
    比较两个对象的值是否相等。
    String
    getLocalizedName()
    返回Level的本地化字符串名称，用于当前默认区域设置。
    String
    getName()
    返回Level的非本地化字符串名称。
    String
    getResourceBundleName()
    返回级别的本地化资源包名称，如果未定义本地化包，则返回null。
    int
    hashCode()
    生成一个哈希码。
    final int
    intValue()
    获取此级别的整数值。
    static Level
    parse(String name)
    将级别名称字符串解析为Level。
    final String
    toString()
    返回此Level的字符串表示形式。

    Methods declared in class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Field Details

    • 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是指示潜在问题的消息级别。

      一般来说，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。

  • Constructor Details

    • Level

      protected Level(String name, int value)
      使用给定的整数值创建一个命名的Level。

      请注意，此构造函数是“protected”的，以允许子类化。一般来说，日志记录的客户端应使用诸如SEVERE或FINEST之类的常量Level对象之一。但是，如果客户端需要添加新的日志级别，它们可以子类化Level并定义新的常量。

      参数:
      name - Level的名称，例如"SEVERE"。
      value - 级别的整数值。
      抛出:
      NullPointerException - 如果名称为null

    • Level

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

  • Method Details

    • getResourceBundleName

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

    • getName

      public String getName()
      返回Level的非本地化字符串名称。
      返回:
      非本地化名称

    • getLocalizedName

      public String getLocalizedName()
      返回Level的本地化字符串名称，用于当前默认区域设置。

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

      返回:
      本地化名称

    • toString

      public final String toString()
      返回此Level的字符串表示形式。
      覆盖:
      toString 在类 Object中
      返回:
      Level的非本地化名称，例如"INFO"。

    • intValue

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

    • parse

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

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

      例如:

      • "SEVERE"
      • "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。
      参见:

    • hashCode

      public int hashCode()
      生成一个哈希码。
      覆盖:
      hashCode 在类 Object中
      返回:
      基于级别值的哈希码
      参见: