xfire
1.概述
Smallnest写的 XFire初级中文教程。
官方网站的User Guide和Quick Start。
JavaWorld的介绍文章
XFire是与Axis 2并列的新一代WebService框架。之所以并称为新一代，因为它：
- 支持一系列Web Service的新标准--JSR181、WSDL2.0 、JAXB2、WS-Security等 ;
- 使用Stax解释XML,性能有了质的提高。XFire采用Woodstox 作Stax实现;
- Easily Create Services from POJOs;
- Spring的结合;
- 灵活的Binding机制，包括默认的Aegis,xmlbeans,jaxb2,castor。
其中第3，4，5项对一个Pragmatic的应用很重要。SpringSide就是使用了这三样，组合了一个比Axis简单得多的WebService最简做法。
关注一个WebService框架，通常关注Java代码遵循什么接口和规范，做什么XML配置，最后执行什么命令来发布一个Web Service，另外还关注Java类如何绑定为XML与其他语言沟通，下面将分别介绍XFire里的最简做法。
2.WebService的最快创建
2.1.抽取WebService用的窄接口
BookManger.java只须为POJO即可，不需要含任何WebService相关代码。
为它抽取一个 for WebService的窄接口BookService.java。
窄接口一方面满足了由于安全原因，不愿意整个XXXManager所有方法导出为Web Service的需求，另一方面，XFire暂时也只支持基于接口的Proxy。
2.2.至简单的Aegis Binding
XFire默认的Aegis Binding语法非常简单，int,String,Date等类型的参数和返回值都无需定义，只要定义一下List findBooksByName()的返回值List里的对象是Book就可以了，是我见过最简单的binding定义，大大优于其他以设计复杂为终极目标的方案。
<mapping>
<method name="findBooksByName">
<return-type componentType="org.springside.bookstore.domain.Book"/>
</method>
</mapping>
为了以约定俗成代替配置，所有Service和Entity Bean的binding文件要求命名为xxx.aegis.xml，而且要和原来的类sit together在同一目录里。
具体介绍见Aegis Binding。
2.3.配置Spring 导出Web服务
配置文件见applicationContext-webservice.xml ，靠一个XFire Exporter将窄接口导出成Web服务，然后靠Spring MVC的URL Mapper将它绑定到某个URL。
XFire对此还提供了基于XBean的简写法，但我等着Spring2.0，就不上XBean了，抽象出一个parent bean后，其实也差不多了。
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<value>/BookService=bookService</value>
</property>
</bean>
<bean id="bookService" parent="baseWebService">
<property name="serviceBean" ref="bookManager"/>
<property name="serviceClass" value="org.springside.bookstore.service.BookService"/>
</bean>
<bean id="baseWebService" class="org.codehaus.xfire.spring.remoting.XFireExporter" abstract="true">
<property name="serviceFactory" ref="xfire.serviceFactory"/>
<property name="xfire" ref="xfire"/>
</bean>
此时，XFire就会导出WebService并显示WSDL如下：
http://localhost:8080/springside/service/BookService?WSDL
另有不依赖于Spring的配置方式，需自行在web.xml配置servlet，在WEB-INF/classes/META-INF/xfire 目录放置services.xml配置文件。
3.Client端代码
1.Client的实现同样只需要POJOs ,Service接口和相应的aegis.xml文件
public static void main(String[] args) {
Service serviceModel = new ObjectServiceFactory().create(BookService.class);
BookService service = (BookService) new XFireProxyFactory().create(
serviceModel,"http://localhost:8080/springside/service/BookService");
List list = service.findBooksByCategory(null);
}
2.另一种动态Client:
Client client = new Client(new URL("http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"));
Object[] results = client.invoke("ConversionRate", new Object[] {"BRL", "UGX"});
3. 第三种方式可以尝试使用XFire的WSDL->Server/Client Side代码的ant命令生成基于Jaxb2绑定的Stub。
4.Web Service的单元测试
XFiire提供了AbstractXFireSpringTest 测试类，无须启动Web容器也能进行测试。
1.protected ApplicationContext createContext()方法
你必须实现这个方法将返回定义的ApplicationContext对象。例如：
protected ApplicationContext createContext() {
return ClassPathXmlApplicationContext(new String[]{"classpath*:applicationContext*.xml"});
}
2. 测试服务端
通过invokeService 调用一段写好的web service请求(XML format)，可以访问web service，并得到返回的docuemnt，可以调用assertValid验证结果是否正确。
Document doc = invokeService("BookService",
"/org/springside/xfire/BookService.FindBooksByName.xml");
assertNoFault(doc);
addNamespace("ss", "http://domain.commons.bookstore.springside.org");
assertValid("//ss:Book/ss:category/ss:descn= \"Java Book\"", doc);
FindBookByName的内容如下：
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<findBooksByName xmlns="http://www.springside.org.cn">
<in1>Java</in1>
</findBooksByName>
</env:Body>
</env:Envelope>
另外如果涉及到hibernate操作，可以使用easyMock，也可以像RealDaoControllerTest那样，自行实现openSession、closeSession操作，避免hibernate lazyload的问题。
3.测试客户端代码
为了在不启动tomcat的情况下测试客户端代码，则测试代码仍然继承于AbstractXFireSpringTest，使用local的URL进行测试
Service serviceModel = new ObjectServiceFactory().create(BookService.class);
XFireProxyFactory factory = new XFireProxyFactory(getXFire());
BookService service = (BookService) factory.create(serviceModel, "xfire.local://BookService");
注意两处红色的地方，和普通的Client代码略有不同，是解决不用启动tomcat跑客户端service测试代码的关键，其中xfire.local://BookService中的ServiceName 为被Export的接口名，与Spring MVC的URL Mapping无关。
5.安全与认证
可以用WS-Security，Xfire用的是WSS4J ，详看 SpringSide里的服务端配置以及以TestCase形式Demo的客户端代码。
也可以写一个认证用户名密码的handler。用户名和密码在WebService请求的<head>中编写。在服务端实现一个hanlder负责在header中读出密码并验证，然后把handler挂到service上。
<bean id="bookWebService" parent="baseWebService">
<property name="serviceBean" ref="bookManager"/>
<property name="serviceClass" value="org.springside.bookstore.plugins.xfire.service.BookService"/>
<property name="inHandlers" ref="authenticationHandler"/>
</bean>
在客户端同样实现一个handler,负责将用户名和密码放入到请求的head中，在客户端代码中挂接此请求，增加代码
Client client = ((XFireProxy) Proxy.getInvocationHandler(bookService)).getClient();
client.addOutHandler(new ClientAuthHandler());
单元测试所编写的web service xml请求也作了相应修改。
6.wsdl2java ant task
在SpringSide的build.xml文件中，增加了wsdl2java的target,利用XFire提供的wsgen task可以从wsdl创建客户端代码。
首先要引入wsgentask，然后调用wsgen：
<taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="compile.classpath"/>
<wsgen outputDirectory="${code_path}" wsdl="${wsdl_path}" package="${code_package}" binding="xmlbeans"/>
其中outputDirectory属性定义了代码输出到的文件夹，wsdl定义了wsdl文件的路径，package则定义了创建的java代码的pachage。
binding可以省略，默认binding为JAXB 2.0，也可以设置为xmlbeans,则binding采用xmlbeans的方式。
7.Tips
7.1. Open Session In View
依然是用spring那个filter，对WebService的URL目录也Filter一下：
<filter-mapping>
<filter-name>hibernateFilter</filter-name>
<url-pattern>/service/*</url-pattern>
</filter-mapping>
7.2 异常处理
以往的模式一般是写一个WebService中间层，负责调用XXXManager，并处理、转化异常。
而XFire是直接export XXXManager的，并提供了一个异常处理的Handler，有默认的实现，也有可扩展的CustomerErrorHandler。