部署使用 bean 管理的持久性、Servlet 或会话 bean 的 SQLJ 应用程序

您可以在应用程序中嵌入 Java™ 结构化查询语言 (SQLJ) 语句,以最大程度提高数据库事务的效率。 必须先部署应用程序并定制所创建的 SQLJ 概要文件,应用程序才能使用 SQLJ。 您可以使用Rational® Application Developer或者DB2® SQLJ 转换器在将应用程序部署到应用服务器之前对其进行转换。

准备工作

使用以下方式创建 SQLJ 应用程序Rational Application Developer或其他开发工具。

有关此任务

要部署未使用容器管理的持久性的 SQLJ 应用程序,请先转换该 SQLJ 应用程序,以便针对应用程序服务器环境对其进行配置。 完成转换后,请通过进行脚本编制或使用 db2sqljcustomizer 工具在应用程序服务器中定制 SQLJ 概要文件。
使用 bean 管理的持久性的应用程序的 SQLJ 支持包括以下功能:
  • 使用管理控制台或通过进行脚本编制来定制和绑定 SQLJ 概要文件。
  • 再次定制和绑定 SQLJ 应用程序而不重新安装应用程序。

过程

  1. 选修的:创建 .java 文件的备份副本。 例如如果你的文件名为MyServlet.java, 复制MyServlet.javaMyServlet.java.bkup
  2. 选修的:将 .java 文件重命名为带有.sqlj扩展名。 例如,如果您的应用程序是一个名为MyServlet.java, 改名MyServlet.javaMyServlet.sqlj
  3. 选修的:编辑 SQLJ 文件以转换JDBC语法转换为 SQLJ 语法。
    使用 SQLJ 时,如果要使应用程序服务器的连接管理功能正常工作,请指定正确的连接上下文。
    例如,将下列 JDBC 操作:
    Connection con = dataSource.getConnection(); 
    Statement stmt = con.createStatement(); 
    stmt.execute("INSERT INTO users VALUES (1, 'user1')"); 
    con.commit();
    转换为下列 SQLJ:
    // At the beginning of the file and just after the import statements, define Connection_Context 
    #sql context Connection_context; 
    . 
    . 
    Connection con = dataSource.getConnection(); 
    . 
    . 
    Connection_context ctx1 = new Connection_context(con); 
    . 
    . 
    #sql [ctx1] {INSERT INTO users VALUES (1, 'user1')}; 
    .  
    .  
    con.commit(); ctx1.close();
    运行 SQLJ 转换器时,.java创建的文件与旧文件同名.java中。 这允许您无缝转换至 SQLJ 技术。
  4. 从你的DB2安装,复制sqlj.zip文件保存到工作站上的目录中。 修改企业 Bean Java 归档(JAR)文件项目的 Java 构建路径,以包含sqlj.zip文件。
  5. 使用Rational Application Developer或者DB2 SQLJ 翻译器自动翻译 SQLJ。
    • 使用Rational Application Developer:
      1. 在“项目导航器”中,右键单击 JAR 项目并选择添加 SQLJ 支持...
      2. 选中需要 SQLJ 支持的应用程序所对应的复选框。
      3. SQLJ JAR 文件字段中,输入先前复制到工作站中的 sqlj.zip 文件的标准路径。
      4. 单击完成
      5. 导出企业归档 (EAR) 文件。
    • 使用DB2 SQLJ 翻译器。 此工具创建一个.java版本的.sqlj文件和序列化的配置文件,.ser扩展,稍后在处理中使用。 请参阅DB2文档以获取有关 SQLJ 转换工具的更多信息。
  6. 对企业应用程序的 JAR 文件进行打包。
  7. 将该应用程序安装到应用程序服务器,或者使用 db2sqljcustomize 工具来定制概要文件。
    • 根据应用程序服务器来定制概要文件。
      1. 将企业 bean、servlet 和任何.ser文件存入企业档案。
      2. 在应用程序服务器中安装应用程序,并使用管理控制台或 wsadmin 工具来定制 SQLJ 概要文件。
        避免麻烦:不選擇部署企业 Bean在管理控制台中的应用程序安装过程中。 如果从管理控制台重新部署企业 Bean,那么将丢失您已进行的定制更改。
        应用程序服务器提供了对 SQLJ 应用程序的增强支持。 请在应用程序服务器中安装 SQLJ 应用程序,您可以通过管理控制台或进行脚本编制来定制和绑定 SQLJ 概要文件:
        • 要使用管理控制台定制 SQLJ 概要文件,请阅读有关定制和绑定 Java 结构化查询语言 (SQLJ) 应用程序的概要文件的主题。
        • 要通过脚本编制来定制 SQLJ 概要文件,请参阅“AdminTask 对象的应用程序管理命令组”主题。
    • 要使用 db2sqljcustomize 工具,请参阅“使用 db2sqljcustomize 工具来定制和绑定 SQLJ 概要文件”主题。