创建 J2C Java bean

创建 IMS Java 数据绑定之后,就需要创建通过“J2EE 连接器体系结构”与 IMS 进行通信的 Java bean。

此 Java bean 包含用于将请求提交给 IMS 以运行 IMS 事务的一种方法。此方法使用 Java 数据绑定来为事务构建输入和输出消息。一个 J2C Java bean 可以包含用于运行 IMS 事务的多种方法,以及不同输入和输出消息的多个数据绑定。为 J2C Java bean 生成的代码使用由 IMS TM 资源适配器提供的 CCI 来与 IMS 进行通信。

要创建运行 IMS 事务的 J2C Java bean,完成下列步骤:

  1. 要启动 J2C 动态向导,请从菜单栏中选择文件 > 新建 > 其他 > J2C
  2. 展开 J2C 文件夹,选择 J2C Java bean 并单击下一步
  3. 在“选择资源适配器”页面中,选择想要使用的 IMS TM 资源适配器版本。 可以选择 JCA 1.0 IMS TM 资源适配器 IMS Connector for Java(IBM:9.1.0.1.1)或者选择 JCA 1.5 IMS TM 资源适配器 IMS Connector for Java(IBM:9.1.0.2)
  4. 单击下一步
  5. 在“连接属性”页面中,选中受管复选框。
    注: 可以采用两种方式来创建 Java bean 所使用的 IMS TM 资源适配器与 IMS Connect 之间的连接。本示例不是一个两层应用程序,因此,只有受管连接才适用。
    • 受管连接是由“J2EE 连接器体系结构”的一种称为连接工厂的结构创建的,并由应用程序服务器来管理。Java bean 将通过使用 JNDI(Java 命名和目录接口)来访问连接工厂。建议使用受管连接。IMS TM 资源适配器与应用程序服务器的连接管理器协同工作,它们通过提供连接池、复用和持久性来高效管理连接。
    • 非受管连接是直接通过 IMS 资源适配器获得的,无需与应用程序服务器协作。通常,两层应用程序才使用非受管连接,并且这种情况下不能创建连接池,也不能复用。另外,IMS TM 资源适配器与 IMS Connect 之间的非受管套接字连接不是持久连接,打开和关闭应用程序使用的每个套接字都将产生额外的开销。
  6. 在“连接属性”页面中,单击“JNDI 查询名称”字段旁边的新建 这将定义一个新的服务器实例。要定义新的服务器实例,会将您在步骤 3 中选择的资源适配器部署至该服务器实例。要在工作空间中创建新的服务器实例,完成下列步骤:
    1. 在“JNDI 查询”向导中,在“选择服务器实例”页面上选择新建
    2. 在“定义新的服务器”页面中,选择您想创建的服务器类型;例如,WebSphere 6.0 服务器。然后单击下一步
    3. 在“WebSphere 服务器设置”页面中,接受缺省值。
    4. 单击完成。这就将您在步骤 3 中选择的资源适配器部署至服务器实例了。
    5. 在“选择服务器实例”页面中,单击下一步
  7. 为刚创建的服务器实例创建并配置 J2C 连接工厂。 您已经为步骤 3 中选择的资源适配器定义了一些 J2C 连接工厂,“J2C 连接工厂”向导允许您从这些连接工厂中选择其中一个连接工厂。如果连接工厂的 JNDI 查询名称还不存在,您可以提供一个名称,或者以后再对它进行定义。要为服务器实例创建并配置 J2C 连接工厂,完成下列步骤:
    1. 在“J2C 连接工厂”页面中,输入新连接工厂的 JNDI 名称。例如,imsCFac
    2. 配置连接工厂。要与 IMS Connect 建立 TCP/IP 连接,至少必须提供下列字段的值:
      • 主机名:字段中,输入应用程序将使用的 IMS Connect 的 TCP/IP 主机名。例如:MYHOST.MYCOMPANY.COM
      • 端口号:字段中,输入端口号。例如,9999
      • 数据存储器名称:字段中,输入目标 IMS 数据存储器。例如,IMSA
    3. 单击完成 这就启动了服务器实例并对它进行了初始化。
  8. 在配置了服务器实例并且启动了服务器之后,连接工厂的 JNDI 名称就会显示在“JNDI 查询名称”字段中。单击下一步
  9. 在“J2C Java Bean 输出属性”页面中,完成下列步骤:
    1. 对于“Java 项目名称”,单击新建
    2. 选择 Java 项目作为项目类型,并单击下一步
    3. 在“创建 Java 项目”页面中,输入 PhoneBookJ2CBean 作为新的 Java 项目名称,接受所有其他缺省值,然后单击完成
    4. 单击“Java 包名”旁边的新建
    5. 在“Java 包”页面中,输入 sample.ims 作为新的 Java 包名,然后单击完成
    6. 对于“接口名称”,指定 PB
    7. 对于“绑定名称”,接受缺省值 PBImpl
    8. 单击下一步
  10. 要创建用来运行事务的方法,使用“Java 方法”向导并完成下列步骤:
    1. 单击添加以将 Java 方法添加至 J2C Java bean。
    2. 在“添加 Java 方法”页面中,输入 runPB 作为 Java 方法名称,然后单击下一步
    3. 在“Java 方法”页面上,单击“输入类型”字段旁边的浏览
    4. 在“选择数据类型”窗口中,在输入字段中输入星号(*)以查看可用的数据类型。
    5. 在“匹配类型”字段中,选择 INPUTMSG 并单击确定以将 INPUTMSG 数据绑定用于 runPB 方法。
    6. 单击“输出类型”字段旁边的浏览
    7. 在“选择数据类型”窗口中,在输入字段中输入星号(*)以查看可用的数据类型。
    8. 在“匹配类型”字段中,选择 OUTPUTMSG,然后单击确定以将 OUTPUTMSG 数据绑定用于 runPB 方法。
    9. 单击完成
  11. “Java 方法”向导就会在 Java bean 的方法列表中显示新方法 runPB (INPUTMSG : OUTPUTMSG)。务必选择此方法。
  12. 在“runPB”的 InteractionSpec 属性中,指定 IMSInteractionSpec 值。对于此示例,接受所有缺省值,然后单击完成
现在,PhoneBookJ2CBean 项目中就存在一个 J2C Java bean 了,可以在使用不同 J2EE 资源的一个或多个 J2EE 应用程序中对它进行部署。

反馈