《XBikes应用安装、配置与运行全指南》

### 《XBikes应用安装、配置与运行全指南》 #### 1. 安装与运行XBikes应用 在单台计算机上安装XBikes应用时，安装过程会复制XBikes示例代码、配置应用服务器并安装XBikes数据库。安装完成后，点击“关闭”即可。 若要运行XBikes应用，可打开浏览器窗口，输入`http://localhost:9080/XBikesWeb` ，需注意“XBikesWeb”大小写敏感。该Web应用允许用户按类型浏览自行车、下单、更改数量以及结算订单。 #### 2. 多计算机配置安装XBikes 在多计算机配置中安装XBikes，需要分别为表示层、业务层和数据层准备三台计算机。这三台计算机都需要进行以下设置： - 安装带有Service Pack 3或更高版本的Windows 2000 Server，且处于工作组模式。 - 默认安装GLUE 4.1.2 Professional。 注意，必须将有效的GLUE许可证文件安装到Glue.jar中，可参考GLUE文档获取帮助。 ##### 2.1 数据层计算机设置 数据层计算机需要安装以下组件： - 具有混合模式安全性和Service Pack 3的Microsoft SQL Server 2000。 - 适用于Microsoft SQL Server 2000的Microsoft JDBC驱动程序。 - 按照相关说明自定义安装IBM WebSphere MQ 5.3。 - 创建XBikesQ消息队列。 - 按照相关说明自定义安装IBM WebSphere Application Server 5.0，包括第3步和第4步中的消息传递客户端安装。 安装XBikes应用到数据层的步骤如下： 1. 打开Windows资源管理器，双击`xbikesj2ee.msi`。 2. 在“欢迎使用XBikes J2EE安装向导”页面，点击“下一步”。 3. 在“安装选项”对话框中，确保选择“仅数据访问层”，然后点击“下一步”。 4. 在第二个“安装选项”对话框中，确保选中“安装源代码”、“安装数据库”和“安装到WebSphere Application Server 5.0”（仅单层级WSAD时取消选中）复选框。若不想查看代码，则无需安装源代码。点击“下一步”继续。 5. 在“确认安装”对话框中，点击“下一步”开始安装。 6. 在“MQ配置”对话框中，输入正确的队列管理器名称（大小写敏感），然后点击“确定”。若安装WebSphere MQ时未记录该名称，可在WebSphere MQ Explorer中查找。 7. 安装过程会复制XBikes示例代码、安装XBikes数据库并配置应用服务器。 8. 安装完成后，点击“关闭”。 ##### 2.2 业务层计算机设置 业务层计算机需要自定义安装IBM WebSphere Application Server 5.0，在安装嵌入式消息传递时选择“服务器和客户端”，而非“仅客户端”。 安装XBikes应用到业务层的步骤如下： 1. 打开Windows资源管理器，双击`xbikesj2ee.msi`。 2. 在“欢迎使用XBikes J2EE安装向导”页面，点击“下一步”。 3. 在“安装选项”对话框中，确保选择“仅业务逻辑层”，然后点击“下一步”。 4. 在第二个“安装选项”对话框中，确保选中“安装源代码”，取消选中“安装数据库”，并选中“安装到WebSphere Application Server 5.0”（仅单层级WSAD时取消选中）复选框。若不想查看代码，则无需安装源代码。点击“下一步”继续。 5. 在“确认安装”对话框中，点击“下一步”。 6. 在“MQ配置”对话框中，输入数据层安装的队列管理器名称（大小写敏感），然后点击“确定”。若安装WebSphere MQ时未记录该名称，可在WebSphere MQ Explorer中查找。 7. 在下一个“MQ配置”对话框中，输入运行WebSphere MQ的计算机的主机名，通常为数据层计算机的名称。安装程序会根据之前输入的队列管理器名称进行最佳猜测。 8. 安装过程会复制XBikes示例代码并配置应用服务器。 9. 安装完成后，点击“关闭”。 ##### 2.3 表示层计算机设置 表示层计算机需要自定义安装IBM WebSphere Application Server 5.0，但不包括第3步和第4步中的消息传递客户端安装。 安装XBikes应用到表示层的步骤如下： 1. 打开Windows资源管理器，双击`xbikesj2ee.msi`。 2. 在“欢迎使用XBikes J2EE安装向导”页面，点击“下一步”。 3. 在“安装选项”对话框中，确保选择“Web层”，然后点击“下一步”。 4. 在第二个“安装选项”对话框中，确保选中“安装源代码”，取消选中“安装数据库”，并选中“安装到WebSphere Application Server 5.0”（仅单层级WSAD时取消选中）复选框。若不想查看代码，则无需安装源代码。点击“下一步”继续。 5. 在“确认安装”对话框中，点击“下一步”，安装过程会复制XBikes示例代码并配置应用服务器。 6. 安装完成后，点击“关闭”。 #### 3. 配置XBikes应用 安装完成后，需要配置Web层和业务层以使用正确的JNDI服务器。 配置Web层进行JNDI查找的步骤如下： 1. 在Web层计算机上，使用记事本打开`C:\Xbikes\Config\Webconfig.xml`配置文件。 2. 找到`<iiop>`标签。 3. 将iiop条目中的“localhost”更改为包含业务层的服务器的IP地址。 4. 保存文件。 配置业务层进行JNDI查找的步骤如下： 1. 在业务层计算机上，使用记事本打开`C:\Xbikes\Config\Bllconfig.xml`配置文件。 2. 找到`<iiop>`标签。 3. 将iiop条目中的“localhost”更改为包含数据层的服务器的IP地址。 4. 保存文件。 #### 4. 运行XBikes应用 运行XBikes应用时，需按以下顺序启动计算机：数据层、业务层，最后是表示层。所有计算机启动后，在表示层计算机上打开浏览器窗口，输入`http://localhost:9080/XBikesWeb` ，注意“XBikesWeb”大小写敏感。 #### 5. 更改互操作性方法 当XBikes Web应用正常运行后，可以更改互操作性方法，使XBikes使用不同的用例适配器或资源互操作性适配器。主要有以下几种选择： - 使用Web服务适配器 - 使用Ja.NET适配器 - 使用消息队列适配器 ##### 5.1 使用Web服务适配器 可以在以下场景中使用Web服务适配器： - 在Web层和业务层之间使用Web服务适配器。 - 在业务层和数据层之间使用Web服务适配器。 若要将XBikes更改为使用Web服务适配器，需要修改应用配置以使用Web服务适配器，使用Web服务的URL更新应用配置，然后重新启动应用服务器。 在Web层和业务层之间使用J2EE Web服务的步骤如下： 1. 打开Windows资源管理器，导航到`C:\Xbikes\Config`文件夹。 2. 使用记事本打开`WebConfig.xml`文件，该文件包含六个互操作性条目，每个用例一个。 3. 找到要更改的用例关联的标签，例如，如果要更改“GetCategories”用例，找到`<GetCategories>` XML标签。 4. 将用例标签中定义的类名更改为`xbikes.usecaseinteropadapters.j2ee.ws.XXXX`，其中“XXXX”是要更改的用例名称（可根据需要更改所有用例）。 5. 找到`<j2eews>`标签，将URL更改为J2EE Web服务的位置。例如，如果J2EE Web服务位于名为J2EEBLL的计算机上，`<j2eews>`标签如下： ```xml <j2eews>http://J2EEBLL:9080/XBikesBLLServiceInterface/services/BLLWSServiceInterface.wsdl</j2eews> ``` 6. 保存`WebConfig.xml`文件。 7. 重新启动包含Web层的应用服务器，以清除缓存的适配器配置文件。 在Web层和业务层之间使用.NET Web服务的步骤与使用J2EE Web服务类似，只是将类名更改为`xbikes.usecaseinteropadapters.net.ws.XXXX`，并找到`<netws>`标签更改URL。 在业务层和数据层之间使用J2EE Web服务的步骤如下： 1. 打开Windows资源管理器，导航到`C:\Xbikes\Config`文件夹。 2. 使用记事本打开