理解旅行预订服务

• 本进程假设是由客户端通过发送一个包含不完整的旅行日程文档的消息所引发的。
• 客户端的旅行日程可以：
  • 没有事先的预订，或者
  • 已有事先的飞机、汽车和/或旅馆预订的组合。
• 旅行预订服务检查前来的客户日程，并处理日程直到期满。
• 如果客户端日程不包含事先的飞机预订，旅行预订服务把日程传到它的伙伴服务（飞机预订服务）来添加飞机预订。
• 飞机预订服务把修改后的日程传回给旅行预订服务。
• 对于汽车和旅馆预订，旅行预订服务都进行类似的处理。在这两种情况下，它把预订的实际置备代理给汽车预订服务和旅馆预订服务。
• 最后，旅行预订服务把完成的日程传回给原来的客户端，结束进程。

预计持续时间：60 分钟

页首

教程需求

在开始前，请确保您重新检查了本节中的需求。

页首

配置和启动 GlassFish 应用程序服务器

在您安装完全版的 6.0 时，就已经包括了 GlassFish 应用程序服务器。NetBeans IDE 将在需要的时候自动启动应用程序服务器。

要启动 GlassFish 应用程序服务器：

1. 如果看不到“服务”窗口，请选择“窗口”>“服务”。
2. 在“服务”窗口中，展开“服务器”节点。
   “服务器”节点应该包含有 GlassFish 应用程序服务器的子节点。如果 GlassFish 应用程序服务器没有出现，请转到要配置 GlassFish 应用程序服务器。

3. 右键单击 GlassFish 应用程序服务器节点，选择“启动”。
   “输出”窗口会显示应用程序启动的日志信息。如果看不到“输出”窗口，请选择“窗口”>“输出”>“输出”。
   当消息 Application server startup complete 显示到“输出”窗口时，应用程序服务器就正在运行了。
   注意：如果 GlassFish 应用程序服务器节点上出现一个绿箭头标记，服务器就在运行。

注意：把应用程序部署到 GlassFish 应用程序服务器时，将自动启动服务器。这样，您就不必手动启动应用程序服务器。

注意：以下过程展示如何配置 IDE 以使用另一个版本的 GlassFish V2 应用程序服务器。

要配置 GlassFish V2 应用程序服务器：

您可能想使用不同版本的应用程序服务器，而不是随 NetBeans 6.0 提供的那个。例如，您也许想从 GlassFish 社区网站下载并安装更新版本的 GlassFish V2 应用程序服务器。

以下过程展示如何配置 NetBeans 6.0 IDE 以使用另一个版本的 GlassFish V2 应用程序服务器。假设您已经下载并安装了另一个版本的应用程序服务器。

1. 在“服务”窗口，右键单击“服务器”节点，并从弹出菜单选择“添加服务器”。
   将打开“添加服务器实例”对话框。
2. 在“选择服务器”页，从列表选择“GlassFish V2”。
3. 单击“下一步”。
   将打开“平台文件夹位置”页。
4. 在“平台位置”字段，使用“浏览”按钮来导航并选择应用程序服务器的安装位置。
   
   如果您把 GlassFish 应用程序服务器安装到了缺省位置，请参考表 1 来找到安装位置。否则，请导航到您安装 GlassFish V2 应用程序服务器的位置。

   表 1：应用程序服务器的缺省安装目录

   平台	安装为...	SOA 的安装位置	工具集的安装位置
   Solaris OS Linux	root	/opt/glassfish-v2	/opt/SUNWappserver
   Solaris OS Linux	user	~/glassfish-v2	~/SUNWappserver
   Mac OS X	N/A	/Applications/NetBeans/glassfish-v2b58g	/Applications/NetBeans/NetBeans 6.0
   Windows	N/A	C:\Program Files\glassfish-v2-b58g	C:\Sun\AppServer

5. 选中“注册本地缺省域”单选按钮并单击“下一步”。
6. 输入域管理员的用户名和口令。
   如果您在安装过程中接受了缺省值，用户名是 admin，口令是 adminadmin。
7. 单击“完成”。

页首

从旅行预订服务样例项目新建项目

1. 从 IDE 的主菜单选择“文件”>“新建项目”。
2. 在“类别”中选择“样例”>“SOA”。
3. 在“项目”下，选择“Travel Reservation Service”，单击“下一步”。

   

4. 接受缺省值，或者键入您想要的项目名称和位置。
   注意在本文档中，项目名称为 TravelReservationService。
5. 单击“完成”。
   “项目”窗口现在包含三个项目节点：一个 BPEL 模块 TravelReservationService、一个复合应用程序项目 TravelReservationServiceApplication 和一个捆绑的 EJB 项目 ReservationPartnerServices。
   

   

页首

打开并部署伙伴 Web 服务项目

旅行预订服务通过公共接口和它的伙伴服务通信。这些接口定义在伙伴特有的的 WSDL 文件中。

IDE 包括一个捆绑的 EJB 项目 ReservationPartnerServices。ReservationPartnerServices 项目包含一个基本的 EJB 和三个伙伴服务基于的 JMS 实现。三个伙伴服务分别是旅馆预订服务、汽车预订服务和飞机预订服务。在您测试运行旅行预订服务进程前，三个伙伴 Web 服务必须部署到捆绑的 GlassFish 应用程序服务器中。

本实现只是用来作为旅行预订服务进程的测试工具。伙伴服务的实现不应该引起 BPEL 开发人员的任何兴趣。它们仅仅是旅行预订服务的可测试性的先决条件。

要部署 ReservationPartnerServices 项目：

1. 在“项目”窗口，右键单击 ReservationPartnerServices 节点，选择“取消部署/部署”。这将部署 ReservationPartnerServices。
2. 通过下列步骤来验证 ReservationPartnerServices 应用程序已成功部署：
   
   
   1. 切换到“运行时”窗口，展开“GlassFish V2”节点。
   2. 展开 Applications 节点，然后展开“EJB 模块”节点。

      

页首

把复合应用程序部署到应用程序服务器

TravelReservationServiceApplication 项目已经包含一个作为 JBI 模块（参见“TravelReservationServiceApplication”>“JBI 模块”>“TravelReservationService.jar”节点）的 BPEL 项目。部署 TravelReservationServiceApplication 复合应用程序以使应用程序服务器能获取服务组合件，进而允许其服务单元运行。

1. 在“项目”窗口中，右键单击 TravelReservationServiceApplication 项目节点，从弹出菜单选择“部署”。
2. 在“警告”对话框，确保“GlassFish V2”被选中，单击“确定”。
   如果您在“输出”窗口中看到了以下消息，则证明部署成功：
   

   

页首

进行旅行预订服务进程的测试运行

测试运行功能使得业务进程开发人员能对他们的进程进行测试运行。BPEL 进程被部署到管理进程生命周期的 BPEL 运行时。一个 BPEL 进程接收或挑拣到能引发进程的活动时启动。

BPEL 进程也是 Web 服务。像其它 Web 服务一样，BPEL 进程伴有一个描述其公共接口的 WSDL 文件。该接口依次描述客户端能获取以创建进程实例的操作和消息。在接收到目标为这些接收活动之一的消息时，BPEL 运行时将创建一个 BPEL 进程实例并把消息交给进程实例处理。

例如，在 TravelReservationService.wsdl 中有一个操作 buildItinerary。这就是 TravelReservationService 客户端将调用以引发与 TravelReservationService 进行对话的操作。

<portType name="TravelReservationPortType">
	<operation name="buildItinerary">
      		<input message="tns:ItineraryIn"/>
      		<output message="tns:ItineraryOut"/>
      		<fault name="itineraryProblem" message="tns:ItineraryFault"/>
	</operation>
</portType>

这样，要测试 BPEL 进程，您必须给 BPEL 发送目标为这些进程接收活动之一的消息。

This version of the BPEL Designer contains features to make this testing a point-and-click experience. Specifically, with the TravelReservationService sample project, you can send buildItinerary requests to the deployed TravelReservationService. 该版本的 BPEL 设计器包含单击鼠标即可测试的功能。特别地，对于 TravelReservationService 项目，您可以发送 buildItinerary 请求给已部署的 TravelReservationService。

要测试运行 TravelReservationService：

1. 展开“TravelReservationServiceApplication”>“Test”节点。
   有 4 个子节点：
   
   
   • HasNoReservations - 没有预订的测试日程
   • HasAirline - 有事先的飞机预订的测试日程
   • HasVehicle - 有事先的飞机和汽车预订的测试日程
   • HasHotel - 有事先的飞机和汽车和旅馆预订的测试日程
   
   These test nodes are actually XML files that contain SOAP message data. Each one represents a different case that can be used to test the TravelReservationService in order to exercise the process in slightly different ways. 这些测试节点实际上是包含 SOAP 消息数据的 XML 文件。每个都代表不同的用例，可用来测试 TravelReservationService，以便用稍微不同的方式运行进程。
2. 右键单击 HasNoReservations 节点，从弹出菜单选择“运行”。
   一旦您选择“运行”操作，IDE 就把 HasNoReservations SOAP 消息发送到 BPEL 运行时。IDE 将指出测试是否成功。

注意：

• 如果您在添加 JBI 模块或部署项目前对其中一个测试场景进行测试运行，测试运行将失败。
• 要解决进行测试运行时的一个服务端点问题，请参见 《BPEL 设计器开发人员指南：疑难解答》中的“端口”段落以获得指令。

页首

调试旅行预订服务进程

您可以用 IDE 来调试您的样例 BPEL 程序。

页首