将 JAR 文件的内容导入 OSGi 插件项目

您可以通过现有 JAR 文件创建插件项目。 当应用程序已经是线程安全型应用程序,并且无需重构或重新编译时,这种方法会很有用。 OSGi 束可以在共用 JVM 环境和 JVM 服务器中运行。

关于此任务

本任务会通过现有 JAR 文件创建新的 OSGi 插件项目。 该 JAR 文件必须位于您的本地文件系统上。

过程

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

结果

您已通过现有 JAR 文件创建了 OSGi 插件项目。

下一步操作

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