使用 JSR-047 記載範例

這個範例示範 TPTP 如何支援以 JDK 1.4.0 或更新版本(亦即 java.util.logging)實作的 JSR-047 記載 API 來記載 Common Base Events。 使用者體驗將 Common Base Events 記載到主控台和「日誌記載代理程式」。

如果您尚未執行這個動作,請利用檔案 > 新建 > 範例... > JSR-047 記載範例來建立範例。

為了將 Common Base Events 記載到以 JDK 1.4.0 或更新版本(亦即 java.util.logging)實作的 JSR-047 日誌程式, 範例的內容包含所需的 Java 原始程式碼、相依關係(不含 java.util.logging 類別)及配置檔。

編譯和執行這個範例需要 JRE 1.4.0 或更新版本(亦即 java.util.logging)。

假設

  1. 從工作台的「側寫和記載視景」中啟動這個應用程式時,已配置 Agent Controller 應用程式或服務來使用 JRE 1.4.0 或更新版本。
  2. 'java.util.logging.config.file' 環境變數設為 JSR-047 記載(亦即 java.util.logging)配置檔 (HyadesLoggingJava14Sample.properties) 的絕對路徑和名稱。例如,<workspace>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties。

啟動

如果要執行這個範例及自動連接到「日誌記載代理程式」,請遵循下列步驟:
  1. 如果工作台的預設 JRE 不是 1.4.0 或更新版本,請修改新建立的 Java 專案(亦即 LoggingJava14Project),以 JRE 1.4.0 或更新版本來編輯和執行(專案 > 內容 > Java 建置路徑 > 程式庫 > JRE_LIB > 移除 > 新增程式庫... > JRE 系統程式庫 > 下一步 > 替代 JRE > 已安裝的 JRE... > 新增... > JRE 起始目錄 > 瀏覽... > [JRE 1.4.0 或更新版] > 確定 > 確定 > 確定 > 完成 > 確定)。
  2. 確認所有的編譯錯誤都已修正。
  3. 如果您使用獨立安裝的 Agent Controller(AC),請確定它已啟動(非必要)。 另外,您也可以使用直接連線,也就是工作台所併入的一組有限數量的 AC 服務。
  4. 開啟「側寫和記載視景」(視窗 > 開啟視景 > 其他... > 側寫和記載)。
  5. 從「側寫和記載視景」中執行範例類別(執行 > 設定檔... > 建立「Java 應用程式」類型的新啟動配置 > 將專案名稱設為範例的專案名稱 > 將 Main 類別設為 'HyadesLoggingJava14Sample' > 切換至引數標籤並選取下列 JVM 內容: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >切換至「監視器」標籤 > 取消選取「Java 側寫」並選取「代理程式探索器」 > 設定檔)。
  6. 過了幾秒之後,應該會自動分離和連接日誌記載代理程式。 請選取探索到的日誌記載代理程式,在「側寫和記載視景」中開啟「日誌視圖」來檢視所記載的 Common Base Event 日誌記錄(視窗 > 顯示視圖 > 其他... > 側寫和記載 > 日誌視圖 > 確定)。
  7. 自動更新「側寫和記載視景」中的「日誌視圖」(用滑鼠右鍵按一下 'HyadesLoggingJava14Sample' 日誌記載代理程式 > 自動更新)。

另外,如果要執行這個範例和手動連接到「日誌記載代理程式」,請遵循下列步驟:

  1. 如果工作台的預設 JRE 不是 1.4.0 或更新版本,請修改新建立的 Java 專案(亦即 LoggingJava14Project),以 JRE 1.4.0 或更新版本來編輯和執行(專案 > 內容 > Java 建置路徑 > 程式庫 > JRE_LIB > 移除 > 新增程式庫... > JRE 系統程式庫 > 下一步 > 替代 JRE > 已安裝的 JRE... > 新增... > JRE 起始目錄 > 瀏覽... > [JRE 1.4.0 或更新版] > 確定 > 確定 > 確定 > 完成 > 確定)。
  2. 確認所有的編譯錯誤都已修正。
  3. 如果您使用獨立安裝的 Agent Controller(AC),請確定它已啟動(非必要)。 另外,您也可以使用直接連線,也就是工作台所併入的一組有限數量的 AC 服務。
  4. 從「Java 視景」中執行範例類別(執行 > 執行... > 建立「Java 應用程式」類型的新啟動配置 > Main 類別 > 搜尋... > HyadesLoggingJava14Sample > 確定 > 切換至引數標籤並選取下列 JVM 內容: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >執行)。
  5. 開啟「側寫和記載」視景(Window > 開啟視景 > 其他... > 側寫和記載)。
  6. 在「側寫和記載視景」中連接至 'HyadesLoggingJava14Sample' 日誌記載代理程式(執行 > 側寫... > 連接 - Java 程序 > 新建 > 「主機」標籤 > 如果您並未使用獨立安裝的 Agent Controller,請使用「本端直接連接」。否則,請使用有效的主機名稱和埠。> 「代理程式」標籤 > 按兩下 HyadesLoggingJava14Sample 代理程式 > 選取「目的地」標籤 > 側寫專案 > 瀏覽... > 'HyadesLoggingJava14Sample' > 確定 > 側寫)。
  7. 開始監督 'HyadesLoggingJava14Sample'「日誌記載代理程式」(<用滑鼠右鍵按一下 'HyadesLoggingJava14Sample'「日誌記載代理程式」> > 開始監督)。
  8. 在「側寫和記載視景」開啟「日誌視圖」以檢視已記載的 Common Base Event 日誌記錄(Window > 顯示視圖 > 其他... > 側寫和記載 > 日誌視圖 > 確定)。
  9. 在「側寫和記載」視景自動更新「日誌視圖」(<用滑鼠右鍵按一下 'HyadesLoggingJava14Sample' 日誌記載代理程式> > 自動更新)。