軟體套件 java.util.logging

提供 Java^TM 2 平臺核心日誌工具的類別和介面。

請參見：
描述

介面摘要

Filter	Filter 可用於為記錄內容提供比記錄級別所提供的更細粒度的控制。
LoggingMXBean	日誌記錄設施的管理介面。

類別摘要

ConsoleHandler	此 Handler 向 System.err 發佈日誌記錄。
ErrorManager	可將 ErrorManager 物件附加到 Handler，以便處理日誌記錄過程中 Handler 上所發生的錯誤。
FileHandler	簡單的檔案日誌記錄 Handler。
Formatter	Formatter 為格式化 LogRecords 提供支持。
Handler	Handler 物件從 Logger 中獲取日誌資訊，並將這些資訊導出。
Level	Level 類別定義了一組可用來控制日誌輸出的標準日誌級別。
Logger	Logger 物件用來記錄特定系統或應用程序元件的日誌訊息。
LoggingPermission	當 SecurityManager 運行的程式碼調用某個日誌記錄控制方法（如 Logger.setLevel）時，SecurityManager 將要檢查的權限。
LogManager	存在一個單一的全體 LogManager 物件，它可用於維護 Logger 和日誌服務的一組共享狀態。
LogRecord	LogRecord 物件用於在日誌框架和單個日誌 Handler 之間傳遞日誌請求。
MemoryHandler	Handler 在記憶體中的循環緩衝區中對請求進行緩衝處理。
SimpleFormatter	以可讀格式輸出 LogRecord 的簡單摘要。
SocketHandler	簡單的網路日誌 Handler。
StreamHandler	基於串流的日誌 Handler。
XMLFormatter	將 LogRecord 格式化為標準 XML 格式。

軟體套件 java.util.logging 的描述

提供 Java^TM 2 平臺核心日誌工具的類別和介面。Logging API 的中心目標是支持在客戶站點進行軟體的維護和服務。

使用日誌有 4 個主要目標：

1. 由最終使用者和系統管理員進行問題診斷。這由簡單的常見問題日誌組成，可在本地解決或追蹤這些問題，如資源不足、安全失敗和簡單的配置錯誤。
2. 由現場服務工程師進行問題診斷。現場服務工程師使用的日誌資訊可以相當複雜和冗長，遠超過系統管理員的要求。通常，這樣的資訊需要特定子系統中的額外日誌記錄。
3. 由開發組織進行問題診斷。在現場出現問題時，必須將捕獲的日誌資訊返回到原開發團隊以供診斷。此日誌資訊可能非常詳細，並且相當費解。這樣的資訊可能包括對特定子系統進行內部執行的詳細追蹤。
4. 由開發人員進行問題診斷。Logging API 還可以用來說明除錯正在開發的應用程序。這可能包括由目標應用程序產生的日誌資訊，以及由低層級別的資源庫產生的日誌資訊。但是要注意，雖然這樣使用非常合理，但是 Logging API 並不用於代替開發環境中已經存在的除錯和解析工具。

此套件的關鍵元素包括：

• Logger：應用程序進行 logging 調用的主要實體。Logger 物件用來記錄特定系統或應用程序元件的日誌訊息。
• LogRecord：用於在 logging 框架和單獨的日誌處理程序之間傳遞 logging 請求。
• Handler：將 LogRecord 物件導出到各種目的地，包括記憶體、輸出串流、終端機、檔案和Socket。為此有各種的 Handler 子類別。其他 Handler 可能由第三方開發並在核心平臺的頂層實作。
• Level：定義一組可以用來控制 logging 輸出的標準 logging 級別。可以配置程序為某些級別輸出 logging，而同時忽略其他輸出。
• Filter：為所記錄的日誌提供日誌級別控制以外的細粒度控制。Logging API 支持通用的過濾器機制，該機制允許應用程序程式碼附加任意的過濾器以控制 logging 輸出。
• Formatter：為格式化 LogRecord 物件提供支持。此套件包括的兩個格式器 SimpleFormatter 和 XMLFormatter 分別用於格式化純文本或 XML 中的日誌記錄。與 Handler 一樣，其他 Formatter 可能由第三方開發。

Logging API 提供靜態和動態的配置控制。靜態控制使現場服務人員可以建立特定的配置，然後重新啟動帶有新 logging 設置的應用程序。動態控制允許對當前正在運行的系統內的 logging 配置進行更新。API 也允許對不同的系統功能領域啟用或禁用 logging。例如，現場服務工程師可能對追蹤所有 AWT 事件感興趣，但是不會對Socket事件或記憶體管理感興趣。

Null 指針

通常，除非在 javadoc 中另行註釋，否則如果傳遞一個 null 參數，則方法和建構子將拋出 NullPointerException。此規則的一個明顯的例外是 Logger 類別中的各種日誌記錄便捷方法（config、entering、exiting、fine、finer、finest、log、logp、logrb、severe、throwing 和 warning 方法）的所有參數，除了初始 Level 參數（如果有）之外，都接受 null 值。

相關文檔

有關控制串流的概觀，請參閱 Java Logging Overview。

從以下版本開始：

1.4