适配器开发工具箱用户指南
仅对 Windows 测试了 TwineBall 服务器、适配器和 ODA。它们可能在其它平台上工作,但对它们进行测试是一项留给用户的练习。
要运行 TwineBall 样本,必须已安装 JDK(最好是 1.3.1)。
为了演示创建、复原、更新和删除(CRUD)操作和真实的元数据驱动的设计,TwineBall
服务器使用实际的数据库来定义其实体和存储其数据。这需要进行某些附加设置。提供了一些脚本使设置变得容易,但是这些脚本将需要稍微修改以与您的系统相匹配。
要设置数据库,请遵循以下步骤。
- 安装 WebSphere Business Integration 适配器框架或 WebSphere InterChange Server 及其所有先决条件。
- 安装 IBM DB2 版本 8 修订包 2。
- 在操作系统中创建下列用户标识:
TwineBall 和 TwineBallAdapter。
为它们提供密码
sample42
- 创建 Twine 数据库。在 setup/SQL
目录中,您将找到 Twine-database.bat 和
Twine-database.sql。
编辑 Twine-database.sql 以将密码与 db2admin 标识相匹配。
- 运行 Twine-database.bat 脚本。您应该不会接收到任何错误消息。如果接收到错误消息,则解决它们后再继续。
- 创建 TwineBall 服务器所需的表。在 setup/SQL
目录中,您将找到 TwineBall-Schema.bat 和 TwineBall-Schema.SQL。
- 运行 TwineBall-Schema.bat 脚本。解决任何错误后再继续。
- 设置事件和归档表。在 setup/SQL
目录中,您将找到 WBIA-Events.sql 和 WBIA-Events.bat。
- 运行 WBIA-Events.bat 脚本。解决任何错误后再继续。
要运行服务器,请遵循以下步骤。
- 通过将所有 Java 源导入 IDE 的项目中,编译
/src 和 JNI_Supplement 目录中的整个 Java 源树。
配置 IDE 以将 InterChange Server 或“适配器框架”的 /lib
目录中的所有 JAR 文件放在 CLASSPATH 中。
- 在“适配器框架”或 InterChange Server 安装的 connectors 目录下创建称为
TwineBall 的目录。
- 使用正常 Java 包结构(即,com.ibm.sample.MyClass 存储为 com/ibm/sample/Myclass.class)将所有已编译的类文件导出至此目录。
- 而且,将 setup\scripts 目录中的所有文件复制到此文件夹中。应用程序通常将在与适配器不同的目录中,但用此方法构造目录将简化安装。
- 将新创建的 TwineBall 目录添加至系统 CLASSPATH 中。这将允许 Java 运行时查找服务器类。
- 确保 Java Development Kit bin 目录位于 CLASSPATH 中。运行
runrmic.bat 文件。这将产生 RMI 通信所需要的存根和框架。
- 在 TwineBall 目录内创建称为 Properties 的新目录。
- 将 TwineBall.policy 和 TwineBall.db2.properties 文件从
dependencies 目录移至此目录并将 TwineBall.db2.properties 重命名为 TwineBall.properties。
- 编辑 TwineBall.properties 文件以将 server.name 更改为您的系统名称。例如,如果您的机器称为
JEFFB,则 server.name 将为 //JEFFB:2112/TwineBallServer。
- 通过执行 runserver 脚本启动
TwineBall 服务器。当它运行时,将出现消息“Server ... has been registered”。
- 保留服务器在窗口中运行。ODA 和适配器将通过 RMI 连接至它。
要启动 TwineBall 连接器,请遵循以下步骤。
- 在“适配器框架”或 InterChange Server 安装的 /connectors 目录内创建称为
TwineBall 的目录。
- 如果您未运行 WebSphere InterChange Server 或“适配器框架”,则将配置文件放在该目录中。
如果正在运行
InterChange Server,则导入该配置。
- 创建对代理程序运行适配器所必需的 WebSphere MQ 队列。如果代理程序是
InterChange Server,则由于您可以使用 IDL 传输,因此这可能不必要。
- 启动“连接器配置器”并将 MessageFileName 标准属性更改为“TwineBallAdapter.txt”。
- 尝试使用启动适配器的常用语法来启动连接器。例如:
start_TwineBall TwineBall WMQI -c
C:\IBM\WebSphereAdapters\connectors\TwineBall\TwineBall.cfg
- 要测试适配器,可在 InterChange Server 中设置传递(Pass-Through)协作,或在非
InterChange Server 方式下颠倒传递和服务调用队列。然而,这些过程不在本文档所讨论的范围内。
要启动 TwineBall ODA,请遵循以下步骤。
- 尝试通过运行 start_twineballODA.bat 文件来启动 ODA。
- 尝试通过“业务对象设计器”来发现 ODA 以便使用它。
- 当选择将从中创建业务对象的节点时,请同时选择要创建的所有业务对象。除非您明确选择了子业务对象,否则将不会创建它们。
可构建 Java 适配器并使用“Java 本机接口”(JNI)来调用 C++ API。有关详细信息,请参阅Java 本机接口(JNI)。
