如果您现有一个 Java 项目,那么可以将其转换为 OSGi 插件项目。OSGi 束可以在共用 JVM 环境和 JVM 服务器中运行。
关于此任务
本任务假设您在工作空间中现有一个 Java 项目,并且希望将其转换为 OSGi 插件项目。
过程
- 在 Package Explorer 视图中,右键单击要转换为插件项目的 Java 项目,然后单击配置 > 转换为插件项目 这样会显示“转换现有项目”对话框。该对话框包含工作空间中所有 Java 项目的列表。选择了一个要转换的项目。您可以更改所做选择,或者选择多个要转换为插件项目的 Java 项目。
- 单击完成。 单击完成之后,Java 项目会转换为插件项目。项目名称不会更改,但项目现在包含清单文件和构建属性文件。
- 必需: 需求:您现在必须编辑插件清单文件和添加 JCICS API 依赖性。
如果未执行这些步骤,那么能够导出和安装束,但束将无法运行。
注: 在 CICS TS V4.2 之前的 CICS 版本中,必须将 Java 类库 dfjcics.jar 添加到 Java 构建路径。
利用 CICS TS V4.2,OSGi 可为您管理构建路径。在执行以下步骤之前,必须先编辑当前构建路径,并除去指向 dfhjcics.jar 的任何引用。如果未除去指向 dfhjcics.jar 的所有引用,那么在运行时会发生 NoSuchMethodException 错误。
- 在 Package Explorer 视图中,右键单击项目名称,然后单击 PDE 工具 > 打开清单。 这样会在清单编辑器中打开清单文件。
- 要点:在 CICS TS V4.2 之前的 CICS 版本中,在 dfjcics.jar JAR 文件中提供 Java 类库(称为 JCICS)。在 CICS TS V4.2 中,在 com.ibm.cics.server.jar 文件中提供该库。
如果您的项目清单包含声明:Import-Package: dfhjcics.jar;,那么在继续剩余步骤之前,必须先除去该声明。
- 选择依赖性选项卡,然后在“导入的程序包”部分中单击添加。 这样会打开“程序包选择”对话框。
- 选择程序包 com.ibm.cics.server,然后单击确定。 该程序包会显示在“导入的程序包”列表中。
- 可选: 可选:如果您的应用程序需要,可重复上一步来安装以下程序包:
表 1. 程序包 |
描述 |
com.ibm.record |
原有程序的 Java API,这些程序使用 VisualAge 随附的 Java 记录框架中的 IByteBuffer。先前位于 dfjcics.jar 文件中。 |
- 按 Ctrl +S 以保存清单文件。
结果
您已将现有 Java 项目成功地转换为插件项目。但是,现在必须更新清单文件以添加 CICS-MainClass 声明。有关更多信息,请参阅相关链接。