使用 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.zipgotcha
  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-nd-mp&topic=tdat_sqljdeploycmptool
文件名:tdat_sqljdeploycmptool.html