java.util.logging

軟體包 java.util.logging 的描述

提供 JavaTM 2 平台核心日誌工具的類和接口。Logging API的中心目標是支持在客戶站點進行軟體的維護和服務。

使用日誌有 4 個主要目標

由最終用戶和系統管理員進行問題診斷。這由簡單的常見問題日誌組成，可在本地解決或跟蹤這些問題，如資源不足、安全失敗和簡單的配置錯誤。

由現場服務工程師進行問題診斷。現場服務工程師使用的日誌信息可以相當複雜和冗長，遠超過系統管理員的要求。通常，這樣的信息需要特定子系統中的額外日誌記錄。

由開發組織進行問題診斷。在現場出現問題時，必須將捕獲的日誌信息返回到原開發團隊以供診斷。此日誌信息可能非常詳細，並且相當費解。這樣的信息可能包括對特定子系統進行內部執行的詳細跟蹤。

由開發人員進行問題診斷。Logging API 還可以用來幫助調試正在開發的應用程式。這可能包括由目標應用程式產生的日誌信息，以及由低級別的庫產生的日誌信息。但是要注意，雖然這樣使用非常合理，但是 Logging API 並不用於代替開發環境中已經存在的調試和分析工具。

此包的關鍵元素包括

Logger：應用程式進行logging調用的主要實體。Logger 對象用來記錄特定系統或應用程式組件的日誌訊息。

LogRecord：用於在 logging 框架和單獨的日誌處理程式之間傳遞 logging 請求。

Handler：將 LogRecord 對象導出到各種目的地，包括記憶體、輸出流、控制台、檔案和套接字。為此有各種的 Handler 子類。其他 Handler 可能由第三方開發並在核心平台的頂層實現。

Level：定義一組可以用來控制 logging 輸出的標準 logging 級別。可以配置程式為某些級別輸出 logging，而同時忽略其他輸出。

Filter：為所記錄的日誌提供日誌級別控制以外的細粒度控制。Logging API 支持通用的過濾器機制，該機制允許應用程式代碼附加任意的過濾器以控制 logging 輸出。

Formatter：為格式化 LogRecord 對象提供支持。此包包括的兩個格式化程式 SimpleFormatter 和 XMLFormatter 分別用於格式化純文本或 XML 中的日誌記錄。與 Handler 一樣，其他 Formatter 可能由第三方開發。

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

Null 指針

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

接口摘要

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 格式。