軟體描述
軟體包 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 值。
相關文檔
有關控制流的概述，請參閱 Java Logging Overview。
從以下版本開始：
1.4
