使用 ejbdeploy 工具来部署使用了容器管理的持久性 (CMP) 的 SQLJ 应用程序

在应用程序中嵌入 Java™ 结构化查询语言 (SQLJ) 语句可以最大程度地提高数据库事务的效率。在应用程序可以利用 SQLJ 之前,必须部署该应用程序并定制所创建的 SQLJ 概要文件。应用程序服务器提供了相应的功能,允许将 SQLJ 用作那些使用了容器管理的持久性的企业 Bean 的持久性机制。请使用 ejbdeploy 工具来部署应用程序。

关于此任务

您可以使用 ejbdeploy 工具来部署 SQLJ 应用程序,以便在独立环境中部署企业应用程序。
另外,应用程序服务器提供了对使用容器管理的持久性 (CMP) 的应用程序的增强 SQLJ 支持。新功能包括:
  • 在应用程序服务器中安装应用程序期间,部署 CMP Bean。
  • 使用管理控制台或通过进行脚本编制来定制和绑定 SQLJ 概要文件。
  • 再次定制和绑定 SQLJ 应用程序,而不需要重新安装应用程序。
这些增强功能降低了为实现容器管理的持久性和 bean 管理的持久性而安装、部署和定制 SQLJ 应用程序的复杂性。有关更多信息,请参阅“部署使用了容器管理的持久性 (CMP) 的 SQLJ 应用程序”主题。

过程

  1. 创建对 DB2® 数据库的自顶向下映射。
  2. 从 DB2 安装中,将 sqlj.zip 文件复制到工作站上的目录中。
  3. 修改企业 Bean JAR 项目的 Java 构建路径,使其包括 sqlj.zip 文件。
  4. 使用 Rational® Application Developer 或 DB2 SQLJ 转换程序来自动转换 SQLJ。
    • 使用 Rational Application Developer:
      1. 在“项目导航器”中,单击 EJB_JAR_PROJECT_NAME > SOURCE_FOLDER > META-INF > backends > database_version。
      2. 在映射编辑器中打开 Map.mapxmi。
      3. 在概述面板中的“企业 Bean”列中,突出显示 JAR 项目名称。必须突出显示 JAR 项目的名称,而不是突出显示所列示的其中一个企业 Bean 的名称。
      4. 在属性面板中,展开 SQLJ。
      5. 将正在使用 SQLJ?设置为 True。
      6. 将转换程序模块设置为工作站上 sqlj.zip 文件的标准路径。
      7. 保存 Map.mapxmi 文件。
      8. 导出企业归档 (EAR) 文件。
    • 使用 DB2 SQLJ 转换程序。此工具将创建 .java 版本的 .sqlj 文件以及将来要在处理中使用的序列化概要文件(扩展名为 .ser)。有关 SQLJ 转换程序工具的更多信息,请参阅 DB2 文档。
  5. 使用 ejbdeploy 工具来部署 EAR 文件。
    1. 验证 app_server_root/bin 目录是否在类路径中。
    2. 运行 ejbdeploy 命令实用程序并指定 -sqlj 选项。 ejbdeploy 命令将生成具有指定名称的 EAR 文件以及名为 application_name.ear.xml 的 Ant 脚本。
      例如:
      ejbdeploy d:\application_name.ear           
                working d:\deployed_application_name.ear 
                -sqlj           
                -dbvendor DB2UDB_V81           
                -cp "C:\PROGRA~1\IBM\SQLLIB\java\sqlj.zip"
      避免故障 避免故障: 请使用类路径选项 -cp 来提供 SQLJ 转换程序 sqlj.zip 文件的位置。ejbdeploy 命令并不会访问系统类路径中的 sqlj.zip。gotcha
  6. 选择定制选项。
    • 请使用应用程序服务器的 SQLJ 支持。安装已部署的应用程序,以便通过应用程序服务器或脚本编制来定制 SQLJ 概要文件。
      1. 在应用程序服务器中安装企业应用程序。
        避免故障 避免故障: 在管理控制台中的应用程序安装过程中,请不要选择部署企业 Bean。如果从管理控制台重新部署企业 Bean,那么将丢失您已进行的定制更改。gotcha
      2. 定制 SQLJ 概要文件。
        • 要了解管理控制台支持,请参阅“定制和绑定 Java 结构化查询语言 (SQLJ) 应用程序的概要文件”主题。
        • 要了解脚本编制支持,请参阅“AdminTask 对象的应用程序管理命令组”主题。
    • 使用 db2sqljcustomize 工具来定制和绑定 SQLJ 概要文件。请参阅“使用 db2sqljcustomize 工具来定制和绑定 SQLJ 概要文件”主题。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tdat_sqljdeploycmptool
文件名:tdat_sqljdeploycmptool.html