将静态解析器从 1.3 迁移到 3.x

3.x 版对 1.3 版的静态解析器结构设计作了更改。已将 org.eclipse.hyades.logging.events.* 类迁移到 org.eclipse.hyades.logging.events.cbe.* 公共基本事件类。

请执行下列步骤来迁移静态解析器:

将日志解析器项目导入当前工作空间

  1. 在“日志和跟踪分析器”中,通过选择文件 > 导入来导入现有的日志解析器项目。
  2. 在“导入”向导中,选择现有项目到工作空间中
  3. 项目内容字段中指定项目位置,然后单击完成。这就将项目内容装入到了工作空间中。

在项目属性中更新 Java 构建路径

  1. 切换到“插件开发”透视图。
  2. 需要将“Java 构建路径”更新为指向当前发行版使用的库。通过右键单击项目打开项目属性,然后选择属性
  3. 在“属性”对话框中,选择 Java 构建路径
  4. 在“Java 构建路径”属性中,选择选项卡。
  5. 在列表中选择所有来自 1.3 的 JAR 文件,然后单击除去
  6. 单击添加外部 JAR 并添加下列库:
  7. 单击确定以保存更改。

更新静态解析器 Java 类以使用公共基本事件 API

需要对静态解析器 Java 类中用于公共基本事件的类进行更新。您需要将 org.eclipse.hyades.logging.events.* 的所有实例迁移到 org.eclipse.hyades.logging.events.cbe.*。例如,如果在 3.x.x 中有下面这一组 import 语句:

import org.eclipse.hyades.logging.events.ICommonBaseEvent;
import org.eclipse.hyades.logging.events.IComponentIdentification;
import org.eclipse.hyades.logging.events.IReportSituation;
import org.eclipse.hyades.logging.events.ISituation;
则需将这些语句更新为:
import org.eclipse.hyades.logging.events.cbe.CommonBaseEvent;
import org.eclipse.hyades.logging.events.cbe.ComponentIdentification;
import org.eclipse.hyades.logging.events.cbe.ReportSituation;
import org.eclipse.hyades.logging.events.cbe.Situation;
要了解有关 org.eclipse.hyades.logging.events.cbe.* 类的详细信息,请参阅公共基本事件编程 API

更新适配器配置文件

现在,适配器中的其它字段在适配器配置编辑器中将被验证。例如,实现创建日期角色创建日期字段的值必须符合 XML 日期时间格式 yyyy-MM-ddThh:mm:ss。在运行适配器之前,确保更正了“问题”视图中显示的任何适配器错误。

  1. 打开日志解析器的适配器文件。右键单击适配器文件并选择打开方式 > 适配器配置编辑器
  2. 更新“问题”视图中列示的未正确指定或丢失的任何字段。例如,在 3.x.x 中,组件字段实现版本角色版本现在是必需字段。
  3. 保存对适配器文件所作的任何更改。

在 plugin.xml 文件中更新版本

在日志解析器插件的 plugin.xml 文件中更新版本号。
  1. 右键单击项目的 plugin.xml 文件,然后选择打开方式 > 插件清单编辑器
  2. 在编辑器中,选择“概述”选项卡。
  3. 更新插件的版本号。
  4. 保存更改。

更改总结

v3.x.x 配置 v1.3.0 配置
Java 构建路径插件 org.eclipse.hyades.logging.adapter.config\hglaconfig.jar
org.eclipse.hyades.logging.core\hlcore.jar
org.eclipse.hyades.logging.core\hlcbe101.jar
org.eclipse.hyades.logging.parsers\hparse.jar
org.eclipse.hyades.logging.adapter\hgla.jar
org.eclipse.emf.ecore\runtime\ecore.jar
org.eclipse.emf.common\runtime\common.jar
org.eclipse.hyades.logging.commons\hlcommons.jar
org.apache.jakarta_commons_logging\commons-logging.jar
org.eclipse.hyades.logging.adapter\hglaconfig.jar
org.eclipse.hyades.logging.core\hlcore.jar
org.eclipse.hyades.logging.core\hlevents.jar
org.eclipse.hyades.logging.parsers\hparser.jar
org.apache.xerces\xmlParserAPIs.jar
org.eclipse.hyades.logging.commons\common-loggings.jar
公共基本事件 API org.eclipse.hyades.logging.events.cbe.* org.eclipse.hyades.logging.events.*
适配器配置文件更改 通过编辑器验证的其它字段:
  • 实现日期
  • 实现版本
  • 角色实现日期
  • 角色版本

相关概念
Hyades 通用日志适配器概述

相关任务
创建日志解析器

相关参考
适配器配置文件结构
适配器配置编辑器