您可以通过现有 JAR 文件创建插件项目。 当应用程序已经是线程安全型应用程序,并且无需重构或重新编译时,这种方法会很有用。 OSGi 束可以在共用 JVM 环境和 JVM 服务器中运行。
关于此任务
本任务会通过现有 JAR 文件创建新的 OSGi 插件项目。 该 JAR 文件必须位于您的本地文件系统上。
过程
- 在 Eclipse 菜单栏上,单击 以打开 "新建" 向导。
- 展开 插件开发 文件夹,然后单击 来自现有 JAR 归档的插件。 单击下一步。
这样会打开“JAR 选择”对话框。
- 找到要转换的 JAR 文件。 如果该文件位于您的 Eclipse 工作空间中,请单击添加。 如果该文件位于计算机上的文件夹中,请单击添加外部,然后浏览至该 JAR 文件。 选择所需文件并单击打开,以在“Jar 选择”对话框中进行添加。 单击下一步。
- 在 项目名称 字段中,输入要创建的项目的名称。 项目名称为必填字段。
- 根据需要完成“插件属性”部分中的以下字段:
- 插件标识
- 插件标识是根据项目名称自动生成的; 但是,您可以根据需要更改标识。
- 插件名称
- 插件名称是根据项目名称自动生成的; 但是,您可以根据需要更改名称。
- 执行环境
- 该字段指定运行插件所需的最低 JRE 级别。 选择与 CICS® 运行时目标平台中的执行环境相匹配的 Java™ 级别。
- 在 "目标平台" 部分中,选择 OSGI 框架 ,然后从菜单中选择 standard 。
- 确保选中 将 JAR 归档解压缩到项目中 ,然后单击 完成。
Eclipse 会在工作空间中创建插件项目。
- 必需: 您现在必须编辑插件清单文件并添加 JCICS API 依赖关系。 如果未执行这些步骤,那么能够导出和安装束,但束将无法运行。
- 在 "包资源管理器" 视图中,右键单击项目名称,然后单击 。
这样会在清单编辑器中打开清单文件。
- 选择 依赖关系 选项卡,然后在 "导入的包" 部分中单击 添加。
这样会打开“程序包选择”对话框。
- 选择软件包 com.ibm.cics.server ,然后单击 确定。
该程序包会显示在“导入的程序包”列表中。
- 可选: 重复上一步以安装以下软件包 (如果应用程序需要此软件包):
- com.ibm.record
- 原有程序的 Java API,这些程序使用 VisualAge 随附的 Java 记录框架中的 IByteBuffer。 先前位于 dfjcics.jar 文件中。
- 选择 以保存清单文件。
结果
您已通过现有 JAR 文件创建了 OSGi 插件项目。
下一步操作
现在必须更新清单文件以添加 CICS-MainClass 声明。 有关更多信息,请参阅相关链接。