将现有 Java 项目转换为插件项目

如果您具有现有 Java 项目,那么可以将其转换为 OSGi 插件项目。 OSGi 束可以在共用 JVM 环境和 JVM 服务器中运行。

关于此任务

本任务假设您在工作空间中现有一个 Java 项目,并且希望将其转换为 OSGi 插件项目。

过程

  1. 在 "包资源管理器" 视图中,右键单击要转换为插件项目的 Java 项目,然后单击 配置 > 转换为插件项目
    此时将显示 "转换现有项目" 对话框。
    "转换现有项目" 对话框的截屏,其中显示可供转换的四个 Java 项目,但当前仅选择了一个 Java 项目。
    此对话框包含工作空间中所有 Java 项目的列表。 选择了一个要转换的项目。 您可以更改所做选择,或者选择多个要转换为插件项目的 Java 项目。
  2. 单击完成
    Java 项目将转换为插件项目。 项目名称不会更改,但项目现在包含清单文件和构建属性文件。
  3. 必需: 您现在必须编辑插件清单文件并添加 JCICS API 依赖关系。 如果未执行这些步骤,那么能够导出和安装束,但束将无法运行。
    注: 在 CICS TS 版本之前的 CICS 版本中 4.2 ,必须将 Java 类库 dfjcics.jar添加到 Java 构建路径。 利用 CICS TS V4.2,OSGi 可为您管理构建路径。 在执行以下步骤之前,必须先编辑当前构建路径,并移除指向 dfhjcics.jar 的任何引用。 如果未除去对 dfhjcics.jar的所有引用,NoSuchMethodException在运行时发生错误。
    1. 在 "包资源管理器" 视图中,右键单击项目名称,然后单击 插件工具 > 打开清单
      这样会在清单编辑器中打开清单文件。
    2. 重要信息: 在 CICS TS 版本 4.2之前的 CICS 版本中,在 dfjcics.jar JAR 文件中提供了 Java 类库 (称为 JCICS)。 在 CICS TS V4.2 中,在 com.ibm.cics.server.jar 文件中提供该库。 如果项目清单包含声明: Import-Package: dfhjcics.jar; ,那么必须先除去声明,然后再继续执行其余步骤。
    3. 选择 依赖关系 选项卡,然后在 "导入的包" 部分中单击 添加
      这样会打开“程序包选择”对话框。
    4. 选择软件包 com.ibm.cics.server ,然后单击 确定
      该程序包会显示在“导入的程序包”列表中。
    5. 可选: 重复上一步以安装以下软件包 (如果应用程序需要此软件包):
      com.ibm.record
      原有程序的 Java API,这些程序使用 VisualAge 随附的 Java 记录框架中的 IByteBuffer。 先前位于 dfjcics.jar 文件中。
    6. 选择 文件 > 保存 以保存清单文件。

结果

您已将现有 Java 项目成功地转换为插件项目。

下一步操作

现在必须更新清单文件以添加 CICS-MainClass 声明。 有关更多信息,请参阅相关链接。