java.util.logging
類別 Level

java.lang.Object
  java.util.logging.Level

所有已實作的介面：

Serializable

public class Level
extends Object
implements Serializable

Level 類別定義了一組可用來控制日誌輸出的標準日誌級別。日誌 Level 物件是有序的，並且是通過有序的整數來指定。在給定的級別上啟用日誌記錄也就啟用了所有較高層級別的日誌記錄。

客戶機一般應該使用預定義的 Level 常數（如 Level.SEVERE）。

各級別按降序排列如下：

• SEVERE（最高值）
• WARNING
• INFO
• CONFIG
• FINE
• FINER
• FINEST（最低值）

此外，還有一個級別 OFF，可用來關閉日誌記錄，使用級別 ALL 啟用所有訊息的日誌記錄。

第三方可通過子類別化 Level 來定義其他的日誌級別。在這種情況下，子類別應該注意選擇唯一的整數級別值，並確保通過定義合適的 readResolve 方法，維護整個序列化過程的 Object 單值屬性。

從以下版本開始：

1.4

另請參見：

序列化表格

欄位摘要

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 WARNING 是指示潛在問題的訊息級別。

建構子摘要

protected	Level(String name, int value) 使用給定的整數值創建一個指定的 Level。
protected	Level(String name, int value, String resourceBundleName) 使用給定的整數值和給定的本地化資源名稱創建一個指定的 Level。

方法摘要

boolean	equals(Object ox) 比較兩個物件值的相等性。
String	getLocalizedName() 返回當前預設語言環境的 Level 的本地化字元串名稱。
String	getName() 返回 Level 的非本地化字元串名稱。
String	getResourceBundleName() 返回級別的本地化資源套件名稱；如果沒有定義本地化包，則返回 null。
int	hashCode() 產生雜湊碼。
int	intValue() 獲得此級別的整數值。
static Level	parse(String name) 將級別名稱字元串解析成 Level。
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 是指示潛在問題的訊息級別。

通常，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.MAX_VALUE。

建構子詳細資訊

Level

protected Level(String name,
                int value)

使用給定的整數值創建一個指定的 Level。

注意，此建構子是“受保護”的，允許子類別化。通常，日誌記錄的客戶機應該使用固定的 Level 物件之一，如 SEVERE 或 FINEST。但是，如果客戶機需要添加新的日誌級別，則它們可能子類別化 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。

方法詳細資訊

getResourceBundleName

public String getResourceBundleName()

返回級別的本地化資源套件名稱；如果沒有定義本地化包，則返回 null。

返回：

本地化資源套件的名稱。

getName

public String getName()

返回 Level 的非本地化字元串名稱。

返回：

非本地化名稱。

getLocalizedName

public String getLocalizedName()

返回當前預設語言環境的 Level 的本地化字元串名稱。

如果沒有可用的本地化資訊，則返回非本地化名稱。

返回：

本地化名稱。

toString

public final String toString()

從類別 Object 複製的描述

返回該物件的字元串表示。通常，toString 方法會返回一個「以文本方式表示」此物件的字元串。結果應是一個簡明但易於讀懂的資訊表達式。建議所有子類別都覆寫此方法。

Object 類別的 toString 方法返回一個字元串，該字元串由類別名（物件是該類別的一個實例）、at 標記符“@”和此物件雜湊碼的無符號十六進製表示組成。換句話說，該方法返回一個字元串，它的值等於：

getClass().getName() + '@' + Integer.toHexString(hashCode())
 

覆寫：

類別 Object 中的 toString

返回：

返回 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)

比較兩個物件值的相等性。

覆寫：

類別 Object 中的 equals

參數：

ox - 要與之比較的參考物件。

返回：

當且僅當兩個物件的級別值相同時才返回 true。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

產生雜湊碼。

覆寫：

類別 Object 中的 hashCode

返回：

級別值的雜湊碼。

另請參見：

Object.equals(java.lang.Object), Hashtable