使用WebLogic将Web站点转换为Web服务(一)

现今，面向服务架构（Service Oriented Architecture，SOA）承诺要帮助企业实现时间到价值的更快转换。这种想法不错，而没有行动，纸上谈兵往往一无所成。在SOA中，人们无法确保IT资产的重用，除非这些资产是可以访问的。SOA实现重用的一种方式是通过Web服务，然而，如果资产没有通过Web服务进行公开，或者公开资产的要求苛刻且代价昂贵，那么实现时间到价值的更快转换就变成了一个无法企及的目标。
但是，如果您想公开的资产可以通过Web接口（例如，公司内部网上的一个传统应用程序）访问，情况会怎么样？如果存在一种非常简单的方式可以把这些资产公开为Web服务，情况又会怎么样？
本文给出了一个完整的例子，通过使用RoboSuite WebLogic Edition产品，把Web站点转换为Web服务。该Web服务所包含的几种操作完整地封装了站点的全部功能。构造该Web服务不需要任何传统的编程，比如编写Java代码。
RoboSuite简介
Kapow RoboSuite是一个Web集成平台，它允许用户轻松集成来自任意具有Web接口的应用程序的数据和功能。RoboSuite创建称为robot的集成组件，它可以接受输入并返回输出（就像一个Java方法一样）。Robot在一个称为RoboServer的服务器上执行。
RoboSuite包含在BEA WebLogic Platform的一个特别版本中，这个特别版本包含几种特性，用于确保与BEA WebLogic Workshop之间的紧密集成。其中一个特性就是一个称为RoboSuite控件的可扩展控件。您可以从WebLogic Workshop中的controls菜单访问它，无需任何编程。在本文的例子中，我使用RoboSuite控件创建了一个控件（JCX文件），并使用它来创建Web服务。
图1从WebLogic的角度显示了RoboSuite架构的概况。图中显示了RoboSuite组件，并说明了它们如何与WebLogic Workshop交互。RoboSuite包含代码生成工具，该工具知道WebLogic Workshop的应用程序和项目结构，可以生成易于使用的portlet和Web服务（.jws文件）。想要了解更多信息，请参见参考资料一节。

图1. RoboSuite体系结构
下载和安装RoboSuite
运行本文的例子需要安装RoboSuite。这只需花费几分钟时间，而且过程相当简单。按照如下步骤，就可以从BEA Web站点下载RoboSuite：
访问www.bea.com。
打开Products菜单，然后从此菜单中选择Third Party Tools项。
在Third Party Tools页面上，找到工具Kapow RoboSuite, BEA WebLogic Edition，然后点击More Information链接。
点击链接Download Kapow RoboSuite, BEA WebLogic Edition.
找到产品Kapow RoboSuite, BEA WebLogic Edition, Version 8.1，然后根据所使用的操作系统点击链接。
按照站点上提供的指导进行安装。
RoboSuite的当前版本是5.5 SR1。
例子简介
这个例子是一个简单的电话记录应用程序，在这个应用程序中，用户可以查找、添加和删除电话号码。为了使例子更能说明问题，我使用了专门为此开发的应用程序，思路是让它可以提供大多数CRM、CMS和HR系统中提供的功能。您会发现，这个例子演示了一个真实的场景。我编写了三个robot，分别提供以下功能：搜索电话号码、添加电话号码和删除电话号码。本文没有描述如何编写这些robot。理由如下：首先，这会使本文的篇幅过长。其次，这是一个完美的真实场景，可以让其他人编写robot，然后您再由这些robot创建控件。编写robot与使用WebLogic Workshop中的应用程序所需的技巧未必相同。第三，RoboSuite文档详细描述了如何编写robot。
本文将重点讲述创建一个RoboSuite控件的过程，该RoboSuite控件所包含的方法描述了上述三个robot所要执行的动作，然后我将展示如何使用这个控件创建具有相同方法的Web服务。这样做的意义在于，当您学会使用各种相关工具之后，就可以在几分钟之内完成从robot到Web服务操作方法的过程。完整的过程包括：编写三个robot；创建Web服务；最后，执行一个简单的测试。总共需要大约一个小时。如果使用传统的集成方法，这个过程需要的时间将会长的多。
Robot简介
尽管本文没有把重点放在如何编写robot上，简要地描述一下robot还是有必要的。robot使用RoboMaker工具编写，该工具是RoboSuite的一部分。Robot类似于程序，但是robot的编程语言是完全可视化的（也就是说，robot没有直接的文本表示；robot实际上是以XML格式保存在.robot文件中，但是该格式是内部使用的，没有归档）。图2显示了RoboMaker中的一个例子robot，顶部给出了robot的步骤。左侧是浏览器视图，显示了当前步骤（以绿色表示）上Web文档的状态，而右侧是robot和当前步骤的配置窗格。

图2. RoboMaker中的add robot
robot被设计为与一个或多个给定的Web站点（或这些站点中的一部分）进行交互。它们在更改站点方面可能具有一些健壮性，但不是一般的crawler。robot可以导航站点、执行登录、填写表单、在表上迭代、从页面提取信息，等等。简而言之，它们可以提供浏览器所能提供的一切功能。robot可以采用专门设计的对象（使用ModelMaker工具创建）作为输入和输出。robot可以使用输入对象来填写表单，而输出对象可以包含从Web站点提取的数据。
robot由RoboServer服务器执行。客户端（在本例中就是控件）发送请求给RoboServer，要求运行某个robot，而RoboServer将会运行该robot并返回响应。请求可以包含输入对象，而响应可以包含输出对象，这取决于robot是否需要输入对象和是否返回输出对象。当robot转换为控件时，该控件将包含一个用于调用robot的方法。该方法包含一些对应于robot输入对象属性的参数。该方法的返回值要么包含robot返回的一个对象列表，要么包含这个列表的一部分（例如，第一个对象、第一个对象的属性，等等）。
表1总结了例子中所使用的robot。

表1. Robot小结
robot和相应的方法都打包在一个称为robot库文件的zip文件中，在本例中称为phone.robotlib。构造robot和创建控件的工程师通常不是一个人，而robot库可以视为在这两者之间交换robot的部署单元。
对例子的解释
在这里，我所做的事情有一点颠倒次序。一般人可能首先创建一个具有某种功能的控件，然后使用这个控件创建Web服务或其他应用程序。我将首先创建一个Web服务，然后再为这个Web服务添加控件。
创建新的Web服务
要创建一个新的Web服务，右击要在其中创建它的Web服务项目，然后选择New > Web Service，如图3所示。

图3. 创建Web服务
本节运行了New File Wizard（参见图4），其中已经预先选择了Web服务文件类型。输入Web服务的名称，然后单击Create。

图4. 选择 Web服务的名称
创建RoboSuite控件
创建Web服务之后，下一步就是创建RoboSuite控件。右击该Web服务，然后选择Add Control > RoboSuite Control，如图5所示。这将运行Insert Control Wizard（参见图6）。这个向导基本上是一个标准的WebLogic Workshop向导，但是其中的步骤3将取决于用户所选择的控件种类。

图5. 添加RoboSuite控件
该向导中的头两个步骤是命名Web服务中的控件实例和命名控件文件（生成的JCX文件）。选择实例名称phone。这对应于Java风格的JCX文件中的一个字段名称，所以在这里必须遵从Java命名约定。JCX文件名类似于Java类名。为控件选择包名称controls，这既是实际的也是必需的做法。JCX文件位于一个称为controls的文件夹中，该文件夹为应用程序提供某种结构（此外，不能把控件放在默认的顶级包中）。

图6. 命名控件
向导的最后一个步骤是配置控件。这个步骤由几个子步骤组成。第一个子步骤是选择robot所在的库。在本例中，robot位于本地文件系统中一个称为phone.robotlib的robot库文件中，所以必须选择Robot Library File at URL选项（参见图7）。另一个可能的robot位置在控件或RoboSuite附带的文档中有所描述。此处我不再详细讲述。

图7. 选择 Robot Library位置
选定Robot Library的位置以后，必须指定有关库的更详细信息（例如库的URL），在本例中也不例外。我们指定了robot库文件在本地文件系统中的位置（参见图8）。

图8. 选择 Robot Library URL
指定了robot的完整位置之后，映射表就会显示库中的robot。映射的目的是定义robot和控件方法之间的映射。如果列表中的映射存在，那么对方法的调用就会导致对指定robot的调用。目标是为所有的三个robot定义映射，这样控件就包含一个可以执行robot所要执行的三种操作的方法：搜索、添加和删除。添加新映射的方法是，右击robot旁边的Mapping列，然后选择New…选项，如图9所示。

图9. 创建新的映射
该步骤运行了Map Editor（参见图10）。Map Editor推荐一种默认映射，它包含一个签名和一个方法的返回类型，从方法的输入参数到robot输入对象的属性的映射，以及从robot输出对象到方法结果的映射。对于add robot，有一个称为PhoneUpdate的输入对象，它有两个属性：name和number。编辑器推荐一种映射，在此映射中，方法的两个参数直接映射为PhoneUpdate对象的属性。对于输入来说，这似乎是合理的映射，所以我们将采用这种方法。

图10.映射编辑器
然而，输出的结果映射并不是您想要的。输出的这个结果映射指定，所有对象都将在一个列表中返回。对于add robot，您知道，有且只有一个对象会被返回，而且该对象是一个PhoneStatus对象。所以，还可以选择一种只返回第一个PhoneStatus对象的结果映射。Java对象PhoneStatus是位于Phone接口中的一个公共静态内部类，而Phone接口定义在所生成的JCX文件中。图11显示了如何选择结果映射。