使用公共记录样本

此样本通过在公共记录样本插件中进行记录来演示公共记录实现在 Eclipse 环境中的使用。可以创建并配置 Eclipse 日志记录(例如,IStatus)和公共基本事件日志记录。然后,可以通过配置用于写入到 Common.Logging.Logger 记录代理程序和 Eclipse 公共记录 XML 日志文件(workspace/.metadata/CommonBaseEvents.xml)的插件记录器来记录新创建的日志记录。可以通过工作台使用代理控制器服务或守护程序来监视 Common.Logging.Logger 记录代理程序。

要向工作空间添加样本:

  1. 选择文件 > 新建 > 项目
  2. 在“新建项目”向导中,选择示例 > 公共记录 > 公共记录样本
  3. 单击下一步以查看项目名称和位置,可选择从提供的缺省项目名称和位置进行更改。
  4. 单击完成

先决条件

编译并运行此样本需要 JRE 1.4.0 或更高版本。

运行该样本需要下列 JAR 文件:

JAR 文件名 包含 JAR 的插件 需求原因
com.ibm.etools.common.logging.jar com.ibm.etools.common.logging 公共记录实现
org.eclipse.emf.common.jar org.eclipse.emf.common 公共基本事件的 Eclipse 建模框架(EMF)依赖项
org.eclipse.emf.ecore.jar org.eclipse.emf.ecore 公共基本事件的 Eclipse 建模框架(EMF)依赖项
hexr.jar org.eclipse.hyades.execution TPTP 记录代理程序依赖项
hl14.jar org.eclipse.hyades.logging.core 对 JSR-047 记录 API 提供 TPTP 支持
hlcbe101.jar org.eclipse.hyades.logging.core 公共基本事件实现
hlcore.jar org.eclipse.hyades.logging.core 公共基本事件的 TPTP 记录核心依赖项
org.eclipse.core.runtime.jar org.eclipse.core.runtime Eclipse 记录实现

运行样本

要运行此样本,请执行以下步骤:

  1. 如果工作台的缺省 JRE 不是 V1.4.0 或更高版本,则通过执行下列步骤来修改新创建的 Java 项目(CommonLoggingProject)以便使用 JRE 1.4.0 或更高版本来编译并执行样本:
    1. 选择 CommonLoggingProject,然后右键单击并选择属性
    2. 在属性对话框中,选择 Java 构建路径
    3. 在“库”选项卡中,选择 JRE 系统库,然后单击除去按钮。
    4. 要添加新的 JRE,请单击添加库按钮。
    5. 在“添加库”对话框中,从列表中选择 JRE 系统库并单击下一步
    6. 选择其他 JRE 选项,并单击已安装的 JRE 以添加 JRE。将打开“已安装的 JRE”的首选项对话框。
    7. 单击添加
    8. 在“添加 JRE”对话框中,指定 JRE 1.4.0 的名称和主目录。单击确定
    9. 单击确定
    10. 单击完成
    11. 单击“属性”对话框中的确定
  2. 确认是否已修正所有编译错误。
  3. 向工作台的搜索路径添加必需的插件(如上所列)。
  4. 创建工作台的运行时实例:
    1. 通过选择窗口 > 首选项来打开“首选项”对话框。
    2. 选择插件开发 > 目标平台
    3. 单击重新装入按钮。
    4. 单击确定
    5. 选择运行 > 运行方式 > Eclipse 应用程序。将启动工作台的新实例。使用新实例来运行下一步。
  5. 通过从主菜单中选择公共记录样本 > 运行来运行公共记录样本。