XFire 最新生火指南(上)

来源:百度文库 编辑:神马文学网 时间:2024/10/01 22:01:02
基于发布在JavaEye的敬畏心情,本文又修改了一遍,与前两天发在blogjava和csdn的版本稍有不同。
XFire 是全球众多牛人在与axis系列对比后一致投票的选择。我比较欣赏的特性有:
与Spring整合,无须生成一堆文件,无须打包独立war,直接将应用中的Pojo导出为Web服务。
Aegis--超简约的默认Java XML 绑定机制,且可以Plugin其他绑定机制。
JSR181--annotatiton驱动的POJO WebService配置。
基于Stax的高性能框架
脱离Web服务器的单元测试能力。
网上的文档与例子总是不新,请大家抛开所有的文档,所有的Axis习惯,单看这份代表XFire1.2.2最简约做法的指南。
2.1 修改web.xml,在Web应用中增加XFire的入口
注意XFire有了自己的Servlet,不再依赖Spring MVC的DispatchServlet,也就远离了大家不熟悉的Spring MVC URL Mapping,与Spring达致完美的整合。
这里指定了路径为/service/* ,即WebService的URL会被默认生成为http://www.xxx.com/yyy/service/BookServiceservice/ServiceName,其中ServiceName默认为下文中的接口名。
xml 代码

xfireservlet-name>
org.codehaus.xfire.spring.XFireSpringServletservlet-class>
servlet>

xfireservlet-name>
/service/*url-pattern>
servlet-mapping>
如果应用使用了Hibernate,使用了OpenSessionInView Filter,注意配置OSIV Filter Filter覆盖xfire servlet的路径,即本例中的/service/*.
2.2 编写窄接口,抽取POJO中要导出的服务
从已有的BookManager.java中,抽取出一个窄接口,仅暴露需要导出为Web Service的方法。而BookManger.java是POJO,不需要任何WebService相关代码。
窄接口一方面满足了安全要求,不用整个BookManager所有方法导出为Web Service;另一方面,XFire暂时也只支持基于接口的Proxy。
public interface BookService {
List findBooksByCategory(String cateoryId);
}
2.3 配置Java-XML Binding
XFire默认的Aegis Binding语法非常简单,在SpringSide的例子里几乎一行配置都不用写,是我见过最简单的binding定义,大大优于其他以设计复杂为终极目标的方案。
对象的属性、函数的参数和返回值如果为int、String、Date等普通类型以及由普通类型组成的复杂对象都无需定义。我见到只有两种情况需要定义:
无法使用泛型定义Collection中元素的类型时--如List findBooks()。如果能写成List findBooks()就也不需要了。
需要为属性定义不同的名字,或者定义复杂对象里的某些属性不要输出。
如果实在需要aegis配置, XFire以约定俗成代替配置(CoC),所有Service和Entity Bean的binding文件要求命名为xxx.aegis.xml,而且要和原来的类sit together在同一目录里。




method>


mapping>
其他语法详见Aegis 参考。
2.4 配置Spring导出
为了节约配置代码,先配置一个基类。注意导出Web服务的Bean不能lazy-init:
xml 代码





bean>
每个Web服务的定义:parent为前面定义的基类,serviceClass 为Web Service的接口,serviceBean为Web Service的接口实现类。
xml 代码



bean>
Web服务导出完毕,用户可在http://localhost/service/BookService?WSDL查看自动生成的WSDL。
上半章完,关于JSR181,Client API与测试部分请看XFire 生火指南(下)