轻松简单地开发Web Services 2

XFire和其它类库　　现在是最后一步了，需要得到所有必需的类库。我们怎样得到它们呢?去XFire网站，下载xfire-distribution-1.0.zip，然后解压到一个本地文件夹。复制下面的jar文件和它的库文件夹到WEB-INF/lib中:
　　? activation-1.0.2.jar
　　? commons-codec-1.3.jar
　　? commons-httpclient-3.0.jar
　　? commons-logging-1.0.4.jar
　　? jaxen-1.1-beta-8.jar
　　? jdom-1.0.jar
　　? log4j-1.2.x.jar
　　? mail-1.3.3_01.jar
　　? spring-1.2.x.jar
　　? stax-api-1.0.jar
　　? wsdl4j-1.5.2.jar
　　? wstx-asl-2.9.jar
　　? xbean-2.1.0.jar
　　? xbean-spring-2.2.jar
　　? xfire-all-1.0.jar
　　? XmlSchema-1.0.jar
　　一切妥当。我们来部署和启动应用程序。为了部署示例应用，只需要复制websvc.war到Apache Tomcat的webapps文件夹中，再等待几秒钟。它将会自动启动。这个应用的全部源代码也包含在这个war文件中。我们的程序已经准备作为一个Web Service了。
1

我们如何知道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)，我们可以得到一个服务的本地代理。
　　就是它了。这个代理就是实际的客户端。现在，我们可以调用它的transferFunds()方法来得到我们需要的Web Service。
　　一旦示例应用发布并启动，就可以尝试servlet URL:
　　http://localhost:8080/websvc/ws。
　　这个Servlet使用默认参数来调用Web Service和显示接收到的响应。页面的最后两行应该读取:
　　Response Received
　　COMPLETED: CDN$ 500.00 was successfully transferred from A/C# 11111-01234 to A/C# 99999-05678
　　现在你可以确定Web Service已经发布并且在运行中了。
　　为了尝试不同的输入值，你可以使用完整的URL，例如:
　　http://localhost:8080/websvc/ws?from=11-2345&to=77-9876&amt=250.00&cur=EUR。
　　基本的Web Services开发步骤清单
　　这个清单总结了将一个Java方法发布为Web Service所必须的步骤:
　　1、 检查Java类的方法和默认构造函数确保为public
　　2、 增加XFire servlet相关条目到web.xml中
　　3、 创建services.xml，把它放到WEB-INF/classes/META-INF/xfire目录下
　　4、 增加XFire和第三方包到你的Web应用的WEB-INF/lib文件夹中
　　这就是所有需要的步骤，是的，相当简单。

XFire的其他高级特性
　　XFire的使用可能比较简单，但是在特性和功能性上，它却占据着领导者的位置。下面是它的高级特性:
　　---本地数据绑定支持POJOs(plain-old Java objects)、XMLBeans、JAXB(Java Architecture for XML Binding)、Castor等等。数据绑定说明了Web Services的XML请求和映射到Java对象的XML响应。
　　---使用StAX(Streaming API for XML)处理XML文档。同DOM的基于树和SAX的事件驱动的处理方式相比，StAX使用了拉(pull)机制，它使处理更快速，内存效率更高。
　　---支持多种传输协议，如HTTP、JMS(Java Message Service)和JVM内部传输。
　　---嵌入式，这是XFire的核心功能之一。你可以把这个SOAP引擎嵌入到你的应用中，完全隐藏所有XFire特定引用，同样所有配置都是程序驱动。
　　---丰富的API，它使XFire可高度自定义，允许开发者在不同的阶段截获请求，并且对他们进行处理。
　　---兼容最新的标准例如SOAP1.1(没有加密远程工程调用，或者RPC)和1.2、WSDL1.1、the Web Services Interoperability Organization’s Basic Profile 1.0、Web Services Addressing和WS-Security。
　　最重要的是，XFire属于新一代Web Services引擎。不仅仅是营销用语，“新一代”有一些重要的意义。Apache Axis是第一代Java语言的Web Services引擎，已经成为了所有后来工具的参考标准。在过去的几年里，Axis以及这些其它的工具已经在很多生产环境中进行了实地测试。从中得出的一个关键的问题就是Web Services并不最适合RPC类型的通信。对于性能和效率，面向文档的消息形式是最好的方式。但是Apache Axis和很多其他的Web Services引擎都被设计成了面向RPC的(尽管它们支持文档形式)。现在，整个行业正在开发新一代的SOAP引擎，设计为面向文档的。Apache已经宣布结束旧版本的Axis引擎开发，现在专注于Axis2，现在它的预发布版本是0.95。XFire在今年的2月份发布了它的第一个产品版本(1.0)。它的下一个版本(1.1)仅仅在几个星期之后就进行了发布。
　　性能
　　Web Services需要消耗很多资源，但是性能方面它们不是那么引人注目。XFire打破了这种趋势。它消耗更少的内存(部分因为 StAX的使用)，但是表现却比多数可比较的SOAP引擎出色。你可以在资源中提供的链接中看到比较的结果。
　　此外，XFire还提供了各种方法来进一步优化性能。一个方法是使用JVM内置传输(in-JVM transport)。如果你知道Web Services和客户端运行在同一个JVM上，你可以选择使用本地传输，它可以大幅提升性能。在示例中的客户端代码，看以下指定服务端点URL的这行:
　　String serviceUrl = "http://localhost:8080/websvc/services/Banking";
　　替换为
　　String serviceUrl = "xfire.local://Banking";
　　你会看到性能上的明显提高，因为它绕过了整个网络层。
　　局限性
　　XFire有些重要的局限性你应该清楚:
　　---开发Web Services的好的实践是从WSDL开始。大部分的SOAP引擎提供了从WSDL生成服务stub的工具。XFire也提供了这样一个工具。但是它是基于注释(annotations-based)的，因此需要J2SE5.0。对于仍坚持使用J2SE1.4.x的人来说，它不是一个令人拍手叫好的工具，因为我们有很多其他方式来编写客户端，一个就是文章中演示的方式。
　　---附件支持，它将会包含在未来发行的版本中。
　　---易于学习的用户向导。XFire团队在这个方面还有很多工作需要做。
　　
　　结论
　　Java当前的趋势是简化技术的使用。因此，我们正看到一波基于POJO的开发成就。同时，面向服务架构(SOA，Services-oriented architecture)和Web Services已经变成了当前行业的热点话题。XFire正是在这种情况下产生的。它能够使POJO发布为最少的Web Services，而只需要付出最小化的努力。从而，它使希望使用这项技术的初级开发者的学习曲线变得平缓。同时，由于它兼容最新标准和提供了丰富的API，XFire为高级用户提供了更多的大好机会。