我的漫漫程序之旅

　　因为使用接口的设计是一个好的实践，所以我们的Java类也实现了一个称为IBankingService的接口。代码十分简单:

package com.mybank.xfire.example; public interface IBankingService {      public String transferFunds(         String fromAccount, String toAccount, double amount, String currency);         }

　　在实际实现中，这样一个方法可能包括各种类型的复杂调用、查询和处理操作。但是我们的示例代码已经最小化了，以至于我们可以集中精力在主要目标上:把这个方法发布为Web Services。

　　你可以看到BankingService是一个普通的Java类，没有任何代码告诉我们它将会在Web Services中使用。好的，这里我们不需要增加任何东西。我们所有的工作都在部署描述符里完成。

　　Web应用的部署描述符

　　在Java中，Web应用程序通常需要至少一个部署描述符(叫做web.xml)对其进行配置。XFire本身是一个基于servlet的应用 程序。因此，我们需要增加必要的引用到描述符文件中。然后我们还必须配置将要创建的Web Services。我们使用一个称为services.xml的新文件来完成这件事。

　　web.xml

　　首先，修改web.xml。我们需要增加下面的XFire servlet相关的条目:

<servlet>         <servlet-name>XFireServlet</servlet-name>         <display-name>XFire Servlet</display-name>         <servlet-class>org.codehaus.xfire.transport.http.XfireConfigurableServlet          </servlet-class>     </servlet>     <servlet-mapping>         <servlet-name>XFireServlet</servlet-name>         <url-pattern>/servlet/XFireServlet/*</url-pattern>     </servlet-mapping>         <servlet-mapping>         <servlet-name>XFireServlet</servlet-name>         <url-pattern>/services/*</url-pattern>     </servlet-mapping>

　　我们如何知道Web Service正在工作呢?

　　为了了解Web Service是否正在工作，我们需要测试。首先，我们测试来看WSDL是否可用。我们在浏览器中输入URL。哪个URL?因为我们的应用程序的war文 件是websvc.war，并且在services.xml中给出的服务名是Banking，WSDL的URL应该是:http: //localhost:8080/websvc/services/Banking?wsdl。

　　请注意:URL的第一部分，例如，http://localhost:8080，可能会根据你的应用服务器不同而不同。无论怎样，当你输入URL后，将会看到一个XML文档，它的根元素是。这个文档叫做服务的WSDL。如果你看到了，这就是你的应用作为Web Service已经可用的第一个证明。

　　但是这个测试是不够的。可能会发生这种情况，可以看到WSDL，但是从客户端程序可能会访问不到服务。因此为了核实服务是否可以访问了，我们必须使用一个客户端进行服务的实际调用来进行一个真正的测试。

　　开发一个客户端

　　你可以使用任何的SOAP工具创建客户端，例如，.Net或者Apache Axis，有很多种方法:使用从WSDL产生的stubs，使用动态代理，等等。在例子中，我们使用一个动态代理，以一个简单的Servlet形式，叫做 WsClient.java。为了保持代码两最小，所有在屏幕显示的元素都放在了doGet()方法中。对Web Service的实际调用由callWebService()方法完成，它相当地简单。和下面的类似:

/* Call the Web service     *     */     public String callWebService(         String fromAccount, String toAccount, double amount, String currency)         throws MalformedURLException, Exception {                 //Create a metadata of the service              Service serviceModel = new ObjectServiceFactory().create(IBankingService.class);                log.debug("callSoapServiceLocal(): got service model." );            //Create a proxy for the deployed service         XFire xfire = XFireFactory.newInstance().getXFire();         XFireProxyFactory factory = new XFireProxyFactory(xfire);                  String serviceUrl = "http://localhost:8080/websvc/services/Banking";                 IBankingService client = null;         try {             client = (IBankingService) factory.create(serviceModel, serviceUrl);         } catch (MalformedURLException e) {             log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());         }                           //Invoke the service         String serviceResponse = "";         try {             serviceResponse = client.transferFunds(fromAccount, toAccount, amount, currency);        } catch (Exception e){             log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());                             serviceResponse = e.toString();         }                log.debug("WsClient.callWebService(): status=" + serviceResponse);                      //Return the response         return serviceResponse;     }

　　这个代码是如何工作的呢?我来解释一下:首先，我们创建一个服务模型，它包含服务的说明——换句话说，就是服务的元数据。我们使用XFire的ObjectServiceFactory从IBankingService.class接口创建这个模型。

　　接着，为XFire获得一个代理工厂对象，它包含了常规的代码，也相当地简单和易懂。这一步中没有任何特定应用的东西。从这个proxyFactory，使用服务模型和服务端点URL(用来获得WSDL)，我们可以得到一个服务的本地代理。