运行 Ant 脚本

为了使运行 DB2® SQLJ 概要文件定制程序(db2sqljcustomize)更容易,可以使用 Ant 脚本。此特定 Ant 脚本是在对 EAR 文件运行批处理 SQLJ ejbdeploy 命令时创建的 Ant 脚本。

会对相关联 EAR 的每个 EJB JAR 中的每个定制概要文件运行该 Ant 脚本。该脚本将用修改过的定制概要文件来更新每个 EJB JAR 文件,并且将用修改过的版本来替换 EAR 中的 JAR 文件。此 Ant 脚本是特定于相应 EAR 文件的,并且它将修改现有的 EAR 文件。此 Ant 脚本对相关联 EAR 文件中的每个 EJB JAR 中每个定制概要文件运行 DB2 SQLJ 概要文件定制程序

注: 如果需要再次运行 ejbdeploy 命令,则还必须再次运行 Ant 脚本。除非更改了 EAR 中的 JAR 文件的数目或名称,或者除非更改了在任何 JAR 文件中使用的数据库后端标识,否则应该不必生成新的属性文件。

运行脚本

  1. 在指定属性目标的情况下,运行 Ant 脚本。
    ant -buildfile out.ear.xml properties

    这将创建名为 out.ear.properties 的属性文件。此文件包含一些属性,它们指定与 EAR 文件中每个定制概要文件相对应的包的缺省名,例如:

    pkg.One.jar.DB2UDBNT_V8_1=PKG2_
    
    pkg.Two.jar.DB2UDBNT_V8_1=PKG1_

    在此示例中,EAR 文件包含两个 EJB JAR 文件,One.jarTwo.jar

  2. 编辑生成的属性文件以更改包名。还可以在此文件中指定其它属性,如数据库 URL、用户或密码:
    url.One.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dbx
    user.One.jar.DB2UDBNT_V8_1=dbuser
    password.One.jar.DB2UDBNT_V8_1=dbpassword
    pkg.One.jar.DB2UDBNT_V8_1=TEST
    url.Two.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dby
    pkg.Two.jar.DB2UDBNT_V8_1=WORK
    注: DB2 只使用您指定的名称中的前七(7)个字符。DB2 SQLJ 概要文件定制程序将使用名称来在数据库中创建四个包。如果指定名称 PKG,则定制程序将创建称为 PKG1、PKG2、PKG3 和 PKG4 的包。
  3. 确保企业 bean 的数据库表存在于数据库中;否则,定制步骤将失败。
  4. 确保 DB2 的 db2jcc.jar 在类路径上。安装 DB2 V8 时它应已添加至类路径。
    注: 从 DB2 版本 8 修订包 2 开始,还必须将许可证 JAR 文件添加至类路径。包含在 JAR 文件中的许可证文件允许连接至服务器。根据您正在使用的数据库服务器的类型,有一些不同的许可证 JAR 文件:
    • db2jcc_license_cu.jar - 适用于 Windows®、UNIX® 和 Cloudscape™ 服务器
    • db2jcc_license_cisuz.jar - 适用于所有服务器
    • db2jcc_license_c.jar - 只适用于 Cloudscape 服务器
总之,下列事件是定制步骤的结果:
  1. 会创建四个包含静态 SQL 的数据库包,每个隔离级别一个

    该脚本将对在数据库中创建的包使用一组缺省名称。

  2. 会更新生成的定制概要文件

    该脚本将用修改过的定制概要文件来更新每个 EJB JAR 文件,并且将用修改过的版本来替换 EAR 中的 JAR 文件。此 Ant 脚本是特定于相应 EAR 文件的,并且它将修改现有的 EAR 文件。对于每个定制概要文件,还有用于指定 URL、用户和密码的属性。缺省情况下,定制概要文件的属性是根据全局属性设置的。

    特定 EAR 文件的此脚本从两个文件读取属性:ejbdeploy.sqlj.properties
    和(缺省情况下)ear_name.properties(其中 ear_name 是 EAR 文件的名称)。ejbdeploy.sqlj.properties 文件是 ejbdeploy 命令生成的所有 Ant 脚本的公共文件,而 ear_name.properties 则特定于 EAR 的 Ant 脚本。通过在运行脚本时指定 script.property.file 属性来让 Ant 脚本使用除 ear_name.properties 之外的文件。

    提示: ejbdeploy.sqlj.properties 文件很适合用来指定全局属性,例如,数据库用户标识和密码。
    注: 关于更新的概要文件的注意事项:
    • 它们在运行时必须可用于生成的代码。
    • 它们必须包括在安装到 WebSphere® Application Server 中的实际 EJB JAR 文件中。

有关运行 Ant 的信息,请参阅 Apache Ant 手册(位于 ant.apache.org/manual/index.html)

现在,可以将更新过的 EAR 文件安装到 WebSphere Application Server 中。

相关概念
DB2 SQLJ 概要文件定制程序
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.