java.util.logging -- Java 記載程式設計介面
java.util.logging.Logger 類別提供可用來記載資料的各種方法。
在 WebSphere® Application Server中，當使用基本日誌和追蹤模式時， Java™ 記載 API (java.util.logging) 會針對 WsLevel.DETAIL 層次或更新版本 (包括 wsLevel.DETAIL、Level.CONFIG、Level.INFO、wsLevel.AUDIT、Level.WARNING、Level.SEVERE 和 WsLevel.FATAL) 所記載的事件自動建立「共用基本事件」。 這些「共用基本事件」是使用與記載訊息的日誌程式相關聯的事件 Factory 來建立的。 如果未指定事件 Factory ， WebSphere Application Server 會使用預設事件 Factory ，它會自動填入 WebSphere Application Server特定資訊。
WebSphere Application Server 使用 java.util.logging.Logger 類別的特殊實作，它會自動建立下列方法的「共用基本事件」:
- 配置
- 資訊
- 警告
- 嚴重
- log: 與 WsLevel.DETAIL 層次或更嚴重的層次一起使用時，除了 log (LogRecord) 以外的所有變式
- logp: 與 WsLevel.DETAIL 層次或更嚴重的層次一起使用
- logrb: 與 WsLevel.DETAIL 層次或更嚴重層次搭配使用時
com.xyz.SomeLoggerName)。 利用 Logger.getAnonymousLogger 和 Logger.getLogger 呼叫來實例化的日誌程式，或 Logger.global 方法不使用 WebSphere Application Server 實作，也不會自動建立「共用基本事件」來記載對它們提出的要求。 使用 Logger.log (LogRecord) 方法直接記載的日誌記錄不會由 WebSphere Application Server 日誌程式自動轉換為「共用基本事件」。
下圖說明應用程式碼如何記載「共用基本事件」:
具名日誌程式和訊息層次事件的 Java 記載 API 處理程序如下:
- 應用程式碼會使用事件特定資料來呼叫具名日誌程式 (WsLevel.DETAIL 或更新版本)。
- 日誌程式會在與日誌程式相關聯的事件 Factory 上使用 createCommonBaseEvent 方法來建立「共用基本事件」。
- 日誌程式會使用與日誌程式相關聯的事件 Factory 來建立「共用基本事件」。
- 日誌程式會將共用基本事件包裝在 CommonBaseEventLogRecord 記錄中，並新增事件特定資料。
- 日誌程式會呼叫「共用基本事件」完整方法。
- 「共用基本事件」會呼叫 ContentHandler completeEvent 方法。
- 內容處理程式會將 XML 範本資料新增至「共用基本事件」(例如，包括元件名稱)。 並非所有內容處理程式都支援範本。
- 內容處理程式會將執行時期資料新增至「共用基本事件」(例如，包括現行執行緒名稱)。
- 日誌程式會將 CommonBaseEventLogRecord 記錄傳遞給處理程式。
- 處理程式會格式化資料並寫入輸出裝置。