传智播客－web service（8）－利用xfire开发WS应用

xfire概述
xfire是下一代java soap框架，提供了方便的API（就应用而言，xfire比axis还要方便点），支持多种绑定机制、容器和传输方式，支持各种标准，性能优良等等，下面是xfire特性的大致列表（如有遗漏，欢迎补充～）：
1.支持多个WS标准(soap、wsdl、ws-I、basic Profile ws-addressing、ws-security)。
2.高性能soap栈(使用基于低内存的STAX模型)。
3.可选绑定方式(aegis、xmlBeans、jaxb1.1、jaxb2.0、castor、jibX)。
4.支持jsr181 API，即可通过注释方式开发WS（用的就是jdk6的注释）。
5.多种传输方式(http、jms、xmpp、in-jvm)。
6.灵活的接口（至少相较axis的API而言是，从代码量就能看出来）。
7.支持多个容器(spring、pico)。
8.利用WsGen命令自动生成客户端、服务器端代码。

 

xfire开发实践简述
1、创建web项目作为服务端，添加jar包，开发服务类（例如利用jsr181、用aegis绑定等技术）。

2、创建/类路径/META-INF/xfire/services.xml（services.xml的配置路径可以在web.xml中更改），services.xml采用了spring和xmlbean方式配置：
<beans xmlns="http://xfire.codehaus.org/config/1.0"> <service> <name>BookService</name> <namespace>http://xfire.codehaus.org/BookService</namespace> <serviceClass>org.codehaus.xfire.demo.BookService</serviceClass> <implementationClass>org.codehaus.xfire.demo.BookServiceImpl</implementationClass> <inHandlers> <handler handlerClass="org.codehaus.xfire.demo.handlers.CheckVersionHandler" /> </inHandlers> </service> </beans> 其中，<beans>是spring的bean方式，而<service>是xml的bean方式。

在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> 3、xfire允许像jdk6的方式那样创建嵌入式http服务（器），包括创建服务实例，注册服务，启动服务器，指定端口等常规步骤。XFireHttpService（相当于服务器）底层用到了jetty(类似于tomcat的web服务器)服务,所以要保证jetty.jar可用。

4、客户端访问：
（1）可以用axis开发的客户端或其他任意可以解析xml与java互换的客户端访问xfire服务端；
（2）可以采用简单xfire客户端访问或使用XFireProxyFactory客户端访问；
（3）采用WsGen命令方式生存客户端存根访问，具体方式请参见前文（wsdl2java）；

5、xfire支持多种xml与java对象的绑定（解析）方式，默认绑定aegis方式。
（1）只支持代码优先（先java后wsdl）模式：代码优先－－bottom-up，文档优先－－top-down；
（2）使用aegis需要类似hibernate的映射文件－－XXX.aegis.xml，前面的XXX和要映射的java类名一致，可配置java对象及其属性是否需要序列化成xml元素，是否可以为空，显示映射xml文件的节点名称等等内容；对于服务类的映射，一般是映射服务类接口而不是实现类（有时候IDE抽风，可能接口和实现类都要映射文件程序才能正常运行）；
（3）aegis也允许使用jsr181支持的xml注释映射java对象；
（4）aegis支持多种数据类型：基本类型、String、数组、集合（注意泛型，集合的嵌套）、日期（Date time Timestamp Calenda）、xml及以上类型的各种组合；对于javabean对象，要确保有空的构造函数，以备xfire创建客户端对象；当然，aegis也支持自定义类型。