深探java.util.logging包

2019-11-18 13:46:26

字體：大中小

來源：轉載

供稿：網友

1.0 java Logging Overview    1.1 Overview of Control Flow      1.2 Log Levels     1.3 Loggers     1.4 Logging Methods     1.5 Handlers     1.6 Formatters     1.7 The LogManager     1.8 Configuration File     1.9 Default Configuration     1.10 Dynamic Configuration Updates     1.11 Native Methods     1.12 xml DTD     1.13 Unique Message IDs     1.14 Security     1.15 Configuration Management     1.16 Packaging     1.17 Localization     1.18 Remote access and Serialization2.0 Examples     2.1 Simple Use     2.2 Changing the Configuration     2.3 Simple Use, Ignoring Global Configuration     2.4 Sample XML Output3.0 Appendix A: DTD for XMLFormatter Output

1.0   JavaTM Logging Overview

Logging APIS在J2SE API Specification.已經被具體描述。這個文檔的目標是提供要害元素的概要。

1.1 Overview of Control Flow 控制流概要

應用程序調用Logger對象來記錄日志。(例1.1) Loggers被以一種層次命名形式來組織起來，并且子Logger可能自它們的父Logger中繼續一些屬性。(例1.2)

應用程序調用Logger對象來記錄日志。這些Logger對象定位LogRecord對象，這是一些被傳送到Handler對象發布的對象(例1.3)。Loggers和Handlers都使用日志級，和（可選）過濾器來決定是否它們對某個特定記錄感愛好(例1.4)。當需要發布一個記錄，一個Handler可以使用一個Formatter來局部化和格式化這條信息，對發布到I/O流之前(例1.5)。

每個Logger保持跟蹤一些輸出Handlers。默認情況下所有Loggers也發送它們的輸出到它們的父Logger(例1.5)。但Logger也可能被配置成忽略上層的Handlers.(例1.6)

一些Handlers可能直接輸出到其它Handlers. 例如，MemoryHandler維護一個LogRecord的內部環緩沖，并在觸發事件它發布它的LogRecords通過一個目標Handler.在這種情況，任何信息都被鏈的最后Handler處理。

這些APIS都是有結構的，所以即使logging被禁用Logger APIS也是輕量級的。假如Logging在給出的日志級別被禁用，Logger會執行一個輕量的比較測試和返回。假如logging在指定的級別被啟用，Logger仍然小心地把化費盡可能減少，在傳LogRecord進入Handlers的時候。非凡地，本地化和格式化是延時的，當Handler請求它們的時候。例如，一個MemoryHandler可以維護一個LogRecords的通知緩沖，在沒有化費格式化的時間。

1.       2Log Levels

每個日志信息都有一個相關的日志級。這個級別粗糙指導日志信息的重要性和緊急性。Log Level 對象封裝成一個整數，較高的數值代表較高的優先級。

Level類定義了七個標準日志級。范圍從FINEST（最低優先級，最小數值）到SERVER（最高優先組，最大數值）

1.       3Loggers

正如前面規定的，客戶代碼發送一個日志請求到Logger對象。每個Logger保持跟蹤它感愛好的日志級，并丟棄小于這個級別的日志。

Loggers通常以實體命名，使用點分隔符命名,例如”java.awt”.這個命名空間是層次的,并于LogManager治理. 這個命名空間通常應該由JAVA包名字空間組織. 但不一定要跟隨..例如,一個Logger名叫”java.awt”有可能處理一個java.awt包的日志請求,但也可能處理一個在sun.awt中的一個類的日志請求.

別外,也可以創建一個匿名Logger, 一個不出現在共享命名空間的Logger. 具體看1.14.

Logger跟蹤它們的父Logger在日志命名空間. 一個Logger的父是它最近的祖先,在日志命名空間. 根Logger(名叫 ””)沒有父. Anonymous logger are all given the root logger as their parent. Logger可能繼續多個屬性從它們的父(在Logger命名空間). 非凡的,一個logger可能繼續:

       *日志級別. 假如一個Logger的級別是設置為null,那么這個日志會從父日志中繼續第一個非null級別.

       *Handlers.默認一個Logger會記錄任何輸出信息到它的父Handlers.,并在樹中遞歸.

       *資源包名. 假如一個日志有一個null資源包名,那么它會繼續任何定義給它的父日志的資源包,并在樹中遞歸.

1.4   Logging Methods

Logger類提供大量方便的方法來產生日志信息. 為了方便,有針對每個級別的方法,以日志級別命名. 例如叫”loger.log(Constants.WARING,…” 開發者可以調用方便的方法”:logger.warning(…”

有兩種日志風格,適應不同風格的用戶.

第一,有直接取得源類和源方法名的方法.這些方法是用來給開發者用的, 一些想快速定位日志信息的源的人. 這個風格的例子是:

       void warning(String source Class, String Source Method, String msg);

第二, 有許多方法不直接取得源類和源方法名. 這些方法是用來給開發者用的, 一些想輕易使用logging和不需要具體源信息的開發者.

第二種法方,Logging框架會盡力檢測那個類和方法調用logging,并會添加這些信息到LogRecord.. 然而,很重要的是自動檢測可能只是大約.

1.5   Handlers

StreamHandler

ConsoleHandler

FileHandler

SocketHandler

MemoryHandler

1.6   Formatters

SimpleFormatter

XMLFormatter

1.       7 logManager

有一個全局LogManager對象跟蹤全局日志信息.這包含:

Logger的層次命名空間.

用配置文件讀取的Logging控制屬性

有一個并只有一個LogManager對像可以通過使用靜態LogManager.getLogManager方法取得..

1.8   Configuration File

Logging配置可以使用一個logging配置文件(會在啟動是被讀取)來初始化.這個配置文件是以java.util.PRoperties的標準格式實現的.

該默認配置文件的位置和使用方法如下:

c:/program files/java/jdk1.5.0/jre/lib/logging.properties

D:/java>java -Djava.util.logging.config.file=d:/java/logging.properties testLogg

er

另一種選擇,logging配置可以通過一個類(可以用來讀取初始化信息的類)來初始化.這個機制充許配置數據從多種源讀取,例如LDAP,JDBC等等.具體看LogManager API Specification.

有一些全局配置信息.,這些信息在LogManager描述中已具體說明,并包含一系列在啟動是安裝的root-level Handlers

初始化配置可以指定級別針對特定的loggers. 這些級別衩應用來已命令的logger 和任何在它的命令層次以下的logger. 各種級別以它們在配置文件中定義的順序來應用.

初始配置可以包含任意的屬性,供Handlers或運行日志子系統的使用. 為了方便,這些屬性應該以handler類或主Logger的句子作為開頭.

例如,MemoryHandler使用一個屬性”java.util.logging.MemoryHandler.size”來決定默認ring緩沖大小.

1.9   default configuration

JRE上的默認配置只是一個默認,它可以被ISVs, 系統治理員, 和最終用戶改變.

默認配置只限制磁盤空間. 這不提供給用戶洪水般的信息,但保證捕捉要害錯誤信息.

默認配置封裝一個單獨handler在root logger, 用來發送信息到控制臺.

1.10 dynamic configuration updates

程序可以更新logging配置在運行時刻,使用以下的任意一種方法:

FileHandlers, MemoryHandlers and PrintHandlers 都可以以多種屬性創建.

新Handlers可以添加,并舊的可以刪除.

新Logger可以被創建并被特定Handlers支持.

級別可以在Handlers上設置.

1.       11私有方法

logging沒有私有方法

1.12XML       DTD

       XML DTD是被XMLFormatter使用的.

DTD是設計來以”<log>”元素作為頂層文檔,單獨log記錄被以”<record>”元素記錄.

注重, 在JVM崩潰的事件中,它有可能沒有被以</log>屬性清楚終止一個XMLFormatter流.. 因此分析log記錄的工具應該要預備沒有終結的流.

1.13 Unique Message IDS

JAVA API不提供該功能,因此程序必需自己實現,并在信息字串中包含.

1.   &

上一篇：深入掌握Java技術 EJB調用原理分析(1)

下一篇：設計模式在EJB中的應用（1）