使用共同記載範例

簡介

本範例示範如何藉由在「共同記載範例」外掛程式中記載記錄,以在 Eclipse 環境中進行「共同記載策略」實作的用法。 使用者會經歷建立及配置 Eclipse 日誌記錄(例如 IStatus)和 Common Base Event 日誌記錄,以及透過針對寫入共同記載日誌程式記載代理程式和 Eclipse 共同記載 XML 日誌檔 (<workspace>/.metadata/CommonBaseEvent.log) 所配置的外掛程式日誌程式,來記載新建立的日誌記錄。 您可以透過 Data Collection Engine 服務或常駐程式以及 Hyades 工作台,監視共同記載日誌程式記載代理程式。


內容

本範例的內容包括示範在 Eclipse 環境中進行「共同記載策略」實作的用法所需的 Java 程式碼和相依關係。


需求

  1. 需要 JRE 1.4.0 或更新版才能編譯及執行本範例。

假設
  1. <workspace> 代表到工作台之工作區的絕對路徑。

相依關係

需要表格中所列出的 JAR 檔才能執行本範例:

JAR 檔 內含的外掛程式 需求原因
logging.jar com.ibm.etools.common.logging 共同記載實作
hlcore.jar org.eclipse.hyades.logging.core Common Base Event 的 Hyades 記載核心相依關係
hlcbe101.jar org.eclipse.hyades.logging.core Common Base Event 實作
ecore.jar org.eclipse.emf.ecore Common Base Event 的 Eclipse 建模組織架構 (EMF) 相依關係
common.jar org.eclipse.emf.common Common Base Event 的 Eclipse 建模組織架構 (EMF) 相依關係
hexcore.jar org.eclipse.hyades.execution.core Hyades 記載代理程式
hexr.jar org.eclipse.hyades.execution.remote Hyades 記載代理程式相依關係
hexl.jar org.eclipse.hyades.execution.local Hyades 記載代理程式相依關係
hl14.jar org.eclipse.hyades.logging.java14 JSR-047 記載 API 的 Hyades 支援

執行步驟

如果要執行本範例,請遵循下列步驟:
  1. 如果工作台的預設 JRE 不是 1.4.0 或更新版,請修改新建立的 Java 專案(亦即 CommonLoggingProject),來使用 JRE 1.4.0 或更新版進行編譯及執行。
    1. 選取 CommonLoggingProject,按一下滑鼠右鍵來選取內容
    2. 在內容對話中,從左窗格的清單中選取 Java 建置路徑
    3. 在「程式庫」標籤下,選取 JRE_LIB,再按一下移除按鈕。
    4. 按一下新增程式庫按鈕,以新增 JRE。
    5. 新增程式庫對話框中,從清單選取 JRE 系統程式庫,再按下一步
    6. 選取替代 JRE 選項,再按一下已安裝的 JRE,以新增 JRE。這時「已安裝的 Java Runtime Environment」喜好設定對話框會開啟。
    7. 按一下「新增」。
    8. 在「新增 JRE」對話框中,指定 JRE 1.4.0 的名稱及起始目錄。按一下確定
    9. 按一下確定
    10. 按一下「完成」。
    11. 按一下內容對話框中的確定
  2. 確認所有的編譯錯誤都已修正。
  3. 在執行本範例之前,請將必要的外掛程式新增至工作台的搜尋路徑中,然後建立工作台的執行時期實例。
  4. 選取「共同記載範例」檔案功能表上的共同記載範例 > 執行,或選取工具列按鈕「綠色圈圈」圖示,以執行「共同記載範例」。