xfire

webservice 简介：

为了实现平台无关,实现独立的访问Web服务, 业界制定了一系列技术标准,下面是一些最重要的技术:
* XML
* SOAP
* WSDL
下图展示了上述技术在工作环境中是如何使用的.


在这里,提供者是可以提供服务的应用组件, 申请者是需要使用服务的客户端程序. 很多其他技术也参与了这个交互过程,但是这里只显示了在Web服务环境中必不可少的核心组件. xfire的example 见附件。

XFire特性

　　XFire是Web Service框架的后起之秀，它从现有的框架中借鉴了许多优秀的理念，力争将Web Service的应用开发难度降到最低。此外，还提供了各种绑定技术、支持多种传输协议，对Web Service体系中许多新的规范提供了支持。简单来说，它具有以下一些特性：

　　支持重要的Web Service规范，如SOAP、WSDL、WS-I Basic Profile,、WS-Addressing、WS-Security等;
　　高性能的SOAP 栈设计;
　　可插拔的绑定，支持POJO、XMLBeans、JAXB1.1、JAXB2以及Castor;
　　支持JSR 181规范，该规范通过JDK 5.0注解将POJO导出为Web Service;
　　支持多种传输协议：HTTP、JMS、XMPP、In-JVM等，其中In-JVM允许我们在不启动Web应用器的情况下，象一般的程序一样测试Web Service应用;
　　易用的API，XFire API简洁明了，便于使用;
　　支持Spring、Pico、Plexus、Loom等容器;
　　支持JBI(Java Business Integration：Java 业务整合)规范，JBI是JSR 208的实现;
　　能够根据WSDL创建客户端和服务器端的存根代码;
　　率先对JAX-WS提供了支持，JAX-WS是JAX-RPC的替代者。
Aegis--超简约的默认Java XML 绑定机制，且可以Plugin其他绑定机制。
基于Stax的高性能框架。
脱离Web服务器的单元测试能力。 XFire 体系及重要API
　　ServiceFactory

　　ServiceFactory是XFire的核心类，它可以将一个POJO生成为一个Web Service。让我们通过一个最简单的例子了解ServiceFactory的用途，假设我们在一个POJO中定义了一个业务，现在希望将其导出为Web Service，通过ServiceFactory可以轻而易举地达到目的：


　　XFire xfire = XFireFactory.newInstance().getXFire();
　　ServiceFactory factory = new ObjectServiceFactory(xfire.getTransportManager(), null);
　　Service service = factory.create(YourService.class);


　　这样我们就为YourService类创建基于SOAP 1.1封装的Web Service。Service的输入输出参数如果为简单类型的对象(由String、int、long等基本类型组成)，无须进行额外的映射设置，对于复杂类型的输入输出Service，XFire将会自动尝试将其序列化(通过Aegis绑定)。紧接着，你就可以注册这个Service。


　　xfire.getServiceRegistry().register(service); //形成name和sample name 与service的map以及注册事件。


　　XFire推荐通过一个接口开放服务，此时，你可以指定一个具体的实现类：


　　service.setProperty(ObjectInvoker.SERVICE_IMPL_CLASS, YourServiceImpl.class);


 
　　Handler

　　一个Handler可以看成是XFire的一个加工套件，XFire通过它们定义SOAP发送和接收之前的各种加工处理逻辑。如Handler可以对SOAP体的内容进行加工处理，或者SOAP头进行处理。可以简单地通过扩展AbstractHandler定义一个自己的Handler类：


　　import org.codehaus.xfire.MessageContext;
　　import org.codehaus.xfire.handler.AbstractHandler;
　　public class YourHandler extends AbstractHandler
　　{
　　public void invoke(MessageContext context)
　　{
　　// Do Sth...
　　}
　　}


　　Handler可以注册到Service或Transport(代表SOAP输入输出的的传输对象)中，在服务请求和响应管道里，Service和Transport注册的Handler将执行额外的处理操作。你可以按如下方式注册Handler：


　　…
　　Servic s = factory.create(YourService.class);
　　s.addInHandler(new YourHandler1());①添加一个Handler，对输入SOAP进行处理
　　s.addOutHandler(new YourHandler2());②添加一个Handler，对输出SOAP进行处理
　　s.addFaultHandler(new YourHandler3());③添加一个Handler，对错误SOAP进行处理
　　…


　　下面的Handler对SOAP头进行处理，添加一些特定的信息：


　　import org.codehaus.xfire.MessageContext;
　　import org.codehaus.xfire.handler.AbstractHandler;
　　public class YourHandler extends AbstractHandler
　　{
　　…
　　public QName[] getUnderstoodHeaders()
　　{
　　return new QName[] { new QName("YourHeader", "urn:your:header:ns") };
　　}
　　}


在管道中以流方式处理SOAP
　　XFire是完全基于流数据处理进行工作的系统，这意味着XFire不是将整个SOAP文档缓存在内存中，而是以管道的方式接收SOAP流数据。这种工作方式的转变带来了可观的性能回报，同时节省了内存的占用。

　　对于习惯了Axis、GLUE等这些基于DOM处理模型Web Service框架的开发者来说，需要一些时间来适应这种转变。

　　XFire从管道中接收一个SOAP请求到返回一个SOAP响应，会经历一系列的阶段。在管道调用的任何一个阶段，XFire都可以添加一些额外的Handler，在对消息进行加工处理后再传入到下一个阶段中。图1展示了XFire管道从接收SOAP请求到返回SOAP响应所经历的所有阶段：


图1 XFire Web Service请求和响应的过程

　　在SOAP请求消息对Web Service发起真正调用之前，分别会经过传输(Transport)、预转发(PreDispatch)、转发(Dispatch)、策略实施(Policy)、用户信息处理(User)、预调用(PreInvoke)、服务调用(Service Invocation)等阶段。当，Web Service调用后，XFire生成响应SOAP消息并通过管道发送给客户端请求者，这一过程会先后经历调用后(PostInvoke)、用户信息处理(User)、策略实施(Policy)、传输(Transport)这四个阶段。每一个阶段都是一个可控点，通过编写并注册一些相应的Handler就可以实施一些额外处理逻辑，如审计、SOAP消息加密、签名、压缩等。

　　将POJO Bean导出为Web Service

　　通过XFire为Spring提供的服务导出器可以轻松地将POJO导出为标准的Web Service，此外，XFire还允许我们使用JSR 181注解对POJO进行标注，无需使用XML配置就可以导出为Web Service，各种复杂的转换细节被巧妙地隐藏在XFire之中。

使用导出器导出Web Service

　　XFire为Spring提供了方便易用的导出器XFireExporter，借助XFireExporter的支持，我们可以在Spring容器中将一个POJO导出为Web Service。BbtForum是Baobaotao论坛业务服务类，它拥有众多的业务方法，我们现在希望将其提供查询最近几天精华帖子数的业务方法开放为Web Service。为了避免过多地开放不必要的接口方法，需要定义了一个BbtForumService窄接口，它定义那些需要开放为Web Service的业务方法：


　　package com.baobaotao.xfire.server;
　　public interface BbtForumService {
　　int getRefinedTopicCount(int lastDay);①查询最近几天论坛精华帖子数的服务接口
　　}


　　将一个业务类所有需要开放为Web Service的方法通过一个窄接口来描述是值得推荐的作法，这让Web Service的接口显得很“干净”。其次，XFire的导出器也需要服务接口的支持，因为它采用基于接口的动态代理技术。真实的业务类当然需要实现Web Service窄接口：


　　package com.baobaotao.service;
　　import javax.jws.WebService;
　　import com.baobaotao.xfire.server.BbtForumService;
　　public class BbtForum implements BbtForumService{①实现Web Service窄接口
　　public int getRefinedTopicCount(int lastDay) {②该方法在窄接口中定义，导出为Web Service服务
　　if(lastDay <= 2) return 10;
　　else if(lastDay <= 5) return 20;
　　else return 32;
　　}
　　…
　　}


　　BbtForum中的方法在真实的系统中应该引用其它的业务类或DAO获取数据库中的真实数据，为了简化实例，我们通过一段简单的代码进行模拟，如②所示。

　　在拥有了窄接口之后中，剩余的工作就是在Spring配置文件中通过XFireExporter将BbtForum#getRefinedTopicCount()方法导出为Web Service，具体配置如代码清单1所示：

链接：　http://searchwebservices.techtarget.com.cn/tips/444/3347444_3.shtml