XFire 最新生火指南(下)
1. JSR181
JSR181式通过annotated POJO ，零配置文件的导出Web服务，是BEA倡导的，JavaEE5里的正规方式， XFire作了良好的支持。
但是，XFire关于JSR181方式的文档还不够清晰，请完整阅读本节以避免其中的数个陷阱。
1.1 参考文章1.2 ApplicationContext.xml因为配置都写在annotation，applicationContext.xml文件的内容比较固定。需要注意JSR181WebAnnotations与HandlerMapping不能lazy init.
<beans?default-autowire="byName"?default-lazy-init="true">?<!--引入XFire的预配置文件-->?<import?resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>??<!--?获得applicationContext中所有bean的JSR181 annotation?-->?<bean?id="webAnnotations"?class="org.codehaus.xfire.annotations.jsr181.Jsr181WebAnnotations"?lazy-init="false"/>?<!--?定义handler mapping,将所有JSR181定义的bean导出为web service?-->?<bean?id="jsr181HandlerMapping"?class="org.codehaus.xfire.spring.remoting.Jsr181HandlerMapping"?lazy-init="false">?<property?name="xfire"?ref="xfire"/>?<property?name="webAnnotations"?ref="webAnnotations"/>?</bean></beans>?
1.3 Interface Impl模式不同于XFire传统模式，窄接口不是必须的，只是考虑到client如果也使用XFire时，有个接口好生成Client而已。
如果采用Interface，Interface将担任主要的配置工作。
首先定义@WebService，可定义自己的NameSpace，如果不定义将采用NameSpace的默认生成算法。
接口中的函数将默认全部导出，不需要再用@WebMethod注释，可以如下例般进行更进一步配置：
@WebService(targetNamespace?=?"http://www.springside.org.cn")Manager不是纯粹的POJO，需要带上@WebService注释，指明InterFace。
@WebService(serviceName?=?"BookService",?陷阱一： 中在Interface中以@WebService(name="BookService")来定义ServiceName，这个做法看起来也比较合理，但实际上需要在Manager中以@WebService(serviceName ="BookService") 来定义，比较古怪。
1.4 纯POJO模式参考文档中的例子，需要配置@WebMethod 指定需要导出的服务
@WebService(name?=?"EchoService", targetNamespace?=?"http://www.openuri.org/2004/04/HelloWorld")?
1.5 Client注意事项陷阱二：和传统模式的client有一点最大的区别，第3个参数需要是实际的Manager类，而不是接口类：
Service serviceModel?=?new?AnnotationServiceFactory().create(BookManager.class);2. ClientXFire的Client并不算强项，一共有三种模式：
2.1 Client开发者拥有Web服务端的classClient与Server是同一个开发团队也好，Server端团队以jar形式提供开发包也好，反正如果能拿到服务端的接口Class和Entity类及aegis 配置文件的话。
传统模式：
Service serviceModel?=?new?ObjectServiceFactory().create(BookService.class);BookService service?=?(BookService)?new?XFireProxyFactory().create(serviceModel, serviceURL);service.findBooksByCategory(cateoryId);JSR181模式，注意这里Server端开发组需要向Client提供BookService的实现类BookManager，而不止于接口类，有点危险：
Service serviceModel?=?new?AnnotationServiceFactory().create(BookManager.class);BookService?=?(BookService)?new?XFireProxyFactory().create(serviceModel, serviceURL);service.findBooksByCategory(cateoryId);?
SpringSide 用泛型封装了一个XFireClientFactory，调用代码如下：
BookService service?=?XFireClientFactory.getClient(serviceURL, BookService.class);BookService service?=?XFireClientFactory.getJSR181Client(serviceURL, BookService.class, BookManager.class);2.2 动态模式动态模式不需要服务端的class，不过性能和复杂对象映射等估计做得不会太好。
来访问服务。测试的方式分两种：
一种是纯服务器角度，不编写客户端代码，以SOAP XML形式发送请求，返回的也是SOAP XML字串，直接对XML进行测试。
一种是编写2.1 中Client代码来进行测试。
前一种的测试的隔离度较高，而后一种比较简便。
3.1 测试基类无论那种方式，都使用Xfire的AbstractXFireSpringTest基类，实现createContext()回调函数。
?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);<beans?default-autowire="byName"?default-lazy-init="true">?<!--引入XFire的预配置文件-->?<import?resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>??<!--?获得applicationContext中所有bean的JSR181 annotation?-->?<bean?id="webAnnotations"?class="org.codehaus.xfire.annotations.jsr181.Jsr181WebAnnotations"?lazy-init="false"/>?<!--?定义handler mapping,将所有JSR181定义的bean导出为web service?-->?<bean?id="jsr181HandlerMapping"?class="org.codehaus.xfire.spring.remoting.Jsr181HandlerMapping"?lazy-init="false">?<property?name="xfire"?ref="xfire"/>?<property?name="webAnnotations"?ref="webAnnotations"/>?</bean></beans>?
1.3 Interface Impl模式不同于XFire传统模式，窄接口不是必须的，只是考虑到client如果也使用XFire时，有个接口好生成Client而已。
如果采用Interface，Interface将担任主要的配置工作。
首先定义@WebService，可定义自己的NameSpace，如果不定义将采用NameSpace的默认生成算法。
接口中的函数将默认全部导出，不需要再用@WebMethod注释，可以如下例般进行更进一步配置：
@WebService(targetNamespace?=?"http://www.springside.org.cn")Manager不是纯粹的POJO，需要带上@WebService注释，指明InterFace。
@WebService(serviceName?=?"BookService",?陷阱一： 中在Interface中以@WebService(name="BookService")来定义ServiceName，这个做法看起来也比较合理，但实际上需要在Manager中以@WebService(serviceName ="BookService") 来定义，比较古怪。
1.4 纯POJO模式参考文档中的例子，需要配置@WebMethod 指定需要导出的服务
@WebService(name?=?"EchoService", targetNamespace?=?"http://www.openuri.org/2004/04/HelloWorld")?
1.5 Client注意事项陷阱二：和传统模式的client有一点最大的区别，第3个参数需要是实际的Manager类，而不是接口类：
Service serviceModel?=?new?AnnotationServiceFactory().create(BookManager.class);2. ClientXFire的Client并不算强项，一共有三种模式：
2.1 Client开发者拥有Web服务端的classClient与Server是同一个开发团队也好，Server端团队以jar形式提供开发包也好，反正如果能拿到服务端的接口Class和Entity类及aegis 配置文件的话。
传统模式：
Service serviceModel?=?new?ObjectServiceFactory().create(BookService.class);BookService service?=?(BookService)?new?XFireProxyFactory().create(serviceModel, serviceURL);service.findBooksByCategory(cateoryId);JSR181模式，注意这里Server端开发组需要向Client提供BookService的实现类BookManager，而不止于接口类，有点危险：
Service serviceModel?=?new?AnnotationServiceFactory().create(BookManager.class);BookService?=?(BookService)?new?XFireProxyFactory().create(serviceModel, serviceURL);service.findBooksByCategory(cateoryId);?
SpringSide 用泛型封装了一个XFireClientFactory，调用代码如下：
BookService service?=?XFireClientFactory.getClient(serviceURL, BookService.class);BookService service?=?XFireClientFactory.getJSR181Client(serviceURL, BookService.class, BookManager.class);2.2 动态模式动态模式不需要服务端的class，不过性能和复杂对象映射等估计做得不会太好。
来访问服务。测试的方式分两种：
一种是纯服务器角度，不编写客户端代码，以SOAP XML形式发送请求，返回的也是SOAP XML字串，直接对XML进行测试。
一种是编写2.1 中Client代码来进行测试。
前一种的测试的隔离度较高，而后一种比较简便。
3.1 测试基类无论那种方式，都使用Xfire的AbstractXFireSpringTest基类，实现createContext()回调函数。
?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);
