使用 Rational Application Developer V7 中的 J2C Ant 脚本（1）

look_w

引言IBM Rational Software Delivery Platform 桌面产品 V7
本文将说明如何定制 Rational Application Developer V7 J2EE Connector (J2C) Tools 所创建的 Ant 脚本。
文中提供不同的 Ant 脚本实例，从根据 COBOL 源生成数据绑定，到生成完整的 J2C bean 访问 CICS/IMS 事务。本文还说明了如何从命令行运行 Ant 脚本的方法。
Ant 是用于构建并自动化过程的强大开发工具。通过使用 IBM Rational Application Developer V7 中的一些核心的 Ant 任务和一些定制的 J2C Ant 任务，您可以为 CICS/IMS 创建完整的 Java™ 2 Platform，Enterprise Edition (J2EE™ platform) Connector 架构 bean。
使用 Ant 来生成 J2C bean 和数据绑定 bean 的好处包括：

• 灵活性：如果后端数据的结构经常变更，那么为固有数据类型的每个修改都重新创建数据绑定 bean 是冗长且容易出错的。利用 J2C Ant 脚本，您可以可靠地重新生成数据绑定 bean，且知道将应用与您第一次使用 J2C 向导时一样的选项。
• 可重复性：人的错误是不可避免的。选择一个错误的 GUI 中的选项，可能会导致整个应用程序失败。此外，调试不总是容易做到的，特别是在那些选项不明确地出现在所生成的工件中时。使用 Ant 脚本，每个选项都明确地写在文件中。如果您有大量的类似固有结构，那么您可以仅仅通过更新 Ant 文件中的一些字段来重复代码生成，从而对每个结构使用相同的选项。
• 可维护性：对 Ant 脚本应用源控制比对所生成的工件更容易，或者比对用于生成应用程序的所编制的过程更容易。

需求本文假设您已经安装了 Rational Application Developer V7.0 及 J2EE Connector (J2C) Tools。本文中所包含的示例 Ant 脚本是用这些 J2C Tools 创建的。
本文还假设您已经使用过 Rational Application Developer 先前版本（例如，版本 6）的 J2C Tools 生成了 J2C Beans 和 Data Binding 文件。本文的重点是 Ant 特性支持，并且不涵盖 J2EE connector Tools 的详细用法。
Rational Application Developer J2C 会话记录在 Rational Application Developer V7.0 的 J2C Tools 中，其中一个新的特性是记录向导会话的功能。该功能让您使用一次向导，并且在 Ant 脚本文件中记录下用户选项和数据。
支持 Ant 脚本生成的向导有两个。

• CICS IMS Data Binding 向导：Ant 脚本将生成一个或多个数据绑定文件。
• J2C Java Bean 向导：Ant 脚本将生成 J2C beans，导入资源适配器及数据绑定文件。

CICS IMS 数据绑定中的 Ant 生成CICS IMS Data Binding 向导允许您根据 cobol、C，或者 PL/1 源码生成数据绑定文件。当您使用向导时，在您生成数据绑定文件之前，您必须在向导中选择不同的选项。Ant 脚本支持将在数据绑定 Ant 脚本文件中保存所有的设置。
图 1 展示了如何打开 CICS IMS Data Binding 向导。

• 选择 File > New > Other。
• 选择J2C > CICS IMS data Binding。

图 1. CICS IMS Data Binding 向导

• 在 CICS Data Binding 向导中单击Next，打开 Data Import 页。
• 选择 COBOL to Java、C to Java，或PL1 to Java映射。
• 选择 cobol、PL1，或 C 源文件。
• 单击 Next，打开 Importer 页。
• 选择 importer 设置，及要导入的数据结构。
• 单击 Next，打开图 2 中展示的 Saving Properties Page。

图 2. CICS IMS Data Binding Wizard Ant 支持在 Saving Properties 页中，指定您的数据绑定文件的名称，以及工程名和工程所在的包名。同样可以选择不同的生成样式。
您将选择Save session as Ant script复选框来使用 Ant 脚本特性。默认的 Data Binding Ant Script 文件名是 Data binding 类名。Ant 脚本的默认位置是 Data Binding 生成所处的当前工程。您可以为 Ant 脚本生成变更名字和位置。
当您使用向导时，如果您要为所有设置生成值，那么 Save All Settings 选项是有用的。通过这种方式，就像您已经为所有属性生成了模板。如果您没有选择 Save All Settings 选项，那么当您使用 CICS IMS Data Binding 向导时，您唯一修改或输入的选项将生成。举例来说，Generation Style 的默认值是  Default。只有当您选择了另一个样式，如 Shorten names 时，在 Ant 脚本中才将生成 Generation Style。   
图 3 展示了 CICS IMS Data Binding 向导的 Saving Properties 页的 Multiple Possible Output (MPO) 案例中的 Ant 支持。  
对于 MPO 案例，打开 CICS IMS Data Binding 向导的步骤，和到达 Saving Properties 页的步骤非常类似上面的那些步骤。唯一的差别是，当您映射到 Data Import 页中时，您将选择 COBOL MPO to Java、C MPO to Java 或PL1 MPO to Java。   
到达 MPO 案例的 Saving Properties 页的步骤。

• 在 CICS IMS Data Binding 向导中单击Next，打开 Data Import 页。
• 选择 COBOL MPO to Java 映射，并选择 cobol、PL1 或 C 源文件。
• 单击 Next 打开 Importer 页。
• 选择要导入的导入者设置和数据结构的列表。
• 单击 Next，打开图 3 中显示的 Saving Properties Page。

注意：关于 Save session as Ant script 和 Save All Settings 的信息与前面的非 MPO 案例中所描述的相同。
图 3. CICS IMS Data Binding Wizard (MPO Case) Ant 支持J2C Java Bean 向导中的 Ant 生成J2C Java Bean 向导创建了一个能够与企业信息系统（Enterprise Information System）通信的 bean。图 4 展示了 J2C Java Bean 向导位于 J2C 文件夹之下。
找到图 4 中展示的 J2C Java Bean 向导：

• 选择 File > New > Other。
• 选择 J2C > J2C Java Bean wizard。

图 4. J2C Java Bean Wizard 图 5 展示了 J2C Java Bean Output Properties 页中的 Save session as Ant Script 支持。要到达该页：

• 选择 J2C Java Bean wizard 并单击 Next。
• 在 Resource Adapter Selection 页中，选择资源适配器并单击 Next。
• Connection Properties 页打开了。输入连接信息并单击Next。
• 现在您将到达 J2C Java Bean Output Properties 页。

图 5. J2C Java Bean Output Properties 页面在 J2C Java Bean Output Properties 页中，指定 J2C Java Bean Interface and Implementation 文件的名称，以及将要生成的工程名和包名。
选择 Save session as Ant script 复选框，使用 Ant 脚本特性。
默认的 J2C Java Bean Ant Script 文件名是 J2C Java Bean 接口的名称。Ant 脚本的默认位置是生成 J2C bean 的当前工程。您可以变更 Ant 脚本生成的名称和位置。当您使用向导时，如果您想要为所有设置生成值，那么Save All Settings 选项是有用的。为了得到信息，获取用过的所有值是一种好的方法，这样做可以令您更容易地在未来变更特定的值。如果您没有选择Save All Settings 选项，那么在您使用 J2C Java Bean 向导时修改或输入的唯一选项将生成。
当您选择了 Save session as Ant script 选项之后，单击 Next 继续向导的其他页面，从而创建其余内容。