WebService流行框架之Axis和CXF
前言
上节课我们对WebService进行了简单的介绍,对于其所应用到的技术有了一定的了解。今天主要讲解下WebService的两个流行的框架Axis和CXF。
正题
一、服务端发布WebService
在讲解之前,我们先来看一下这篇博客主要讲解的内容:
每一种框架都有自己的特点,有自己的侧重,但是他们的共同之处在于对发布WebService进行了封装,所以我们只需编写一个配置文件或者使用@WebService注解就可以发布WebService,我们这里着重说一下他们各自的特点:
1.Axis1
Axis1有两种发布方式:
1)JWS方式
a.这种方式很简单,只需要将源码java文件放到AXIS_HOME下面,然后将后缀改为.jws,这样,Axis 会自动编译.jws文件,并把它自动加入到Java WebServie的服务中。
b.但是这种方式的缺点是:只能是java源代码,同时类中不能含有包名。
2)WSDD方式
1.写一个java类(需要引入axis的jar包)
2.配置web.xml文件(配置AxisServlet,AdminServlet,SOAPMonitorService和AxisHTTPSessionListener)
3.写一个deloy.wsdd文件,部署项目(tomcat启动就可以部署项目)
安装axis1到tomcat:
1.Axis官方网站:http://ws.apache.org/axis/,可以在官网下载最新1.4的包:axis-bin-1_4.zip
2.将解压后的axis-1_4\webapps\下的axis目录考到%TOMCAT_HOME%/Webapps/目录下
3.启动tomcat后在浏览器里输入http://localhost:port/axis
4.点击上图中的Validataion链接,页面上会提示已经有的包和缺少的包的信息,根据提示将必须的包下载全,
将这些类包复制到%tomcathome%/webapps/axis/WEB-INF/lib/目录下
重新启动tomcat,直到Validation页面中看不到有Error与Warning的提示信息。
2.Axis2
客户端对于数据类型的不同有两种调用方式:RPCServiceClient和OMAbstractFactory方式
1)RPC方式:
处理基本的数据类型,如String,int等
2)OM方式:
可处理基本数据类型和自定义数据类型(比如java实体对象):通过xml的参数形式进行传递(传递的参数需要转换为OMElement)
注:如果参数或返回值是List类型则需要进行手动处理转换(手动编写一个服务端对传递过来的参数进行处理,将传过来的OMElement手动转换为List类型,调用执行方法,然后将返回的List类型再转换为OMElement传回客户端)
Axis2发布文件(编写services.xml)
1.将官网下载的axis2.war包拷贝到tomcat_home/webapps下,运行即会解压
2.将其conf,modules和services文件夹拷贝到项目的WEB-INF下面,并将lib下的jar包拷贝到web-inf/lib下面
3.配置Web.xml(配置AxisServlet和AxisAdminServlet)
4.编写services下面的services.xml文件,指定要发布的类
3.CXF
CXF发布WebService有三种方式:main方式,基于和不基于Spring发布到容器
1)main方式
引入jar包,在接口和实现类上使用@WebService即可,发布完成后即可在浏览器中访问url,不需要启动tomcat等服务。
2)不基于Spring方式发布到容器
a)引入cxf的jar包,编写web.xml(配置自定义的CXFServlet,该CXFServlet需要继承CXFNonSpringServlet)
b)编写实体类,业务类和服务类(实体类需要和服务类在同一包下,否则报错)
c)启动Tomcat,即可发布服务
3)基于Spring方式发布到容器
a)web.xml配置(Spring配置,cxf封装的CXFServlet配置)
b)applicationContext-server.xml配置
<!--Import apache CXF bean definition 固定-->
<importresource="classpath:META-INF/cxf/cxf.xml" />
<importresource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
<importresource="classpath:META-INF/cxf/cxf-servlet.xml" />
<!--services接口配置 -->
<beanid="helloServicesBean"class="com.ms.services.impl.HelloServicesImpl" />
<!--CXF 配置WebServices的服务名及访问地址 -->
<jaxws:serverid="helloServices" address="/HelloServices"
serviceClass="com.ms.services.IHelloServices">
<!--要暴露的webservice服务 -->
<jaxws:serviceBean>
<refbean="helloServicesBean"/>
</jaxws:serviceBean>
</jaxws:server>
c)编写类
实体类
服务接口(类头使用@WebService)
服务实现(类头使用@WebService(endpointInterface="com.ms.services.IHelloServices"))
以上是关于Axis和CXF发布特点及其需要注意的地方,是我做例子时的总结,有兴趣的同学可以下载源码。
二、客户端调用WebService
服务端将接口发布成功后,就等着客户端来进行调用了,客户端如何并通过什么方式来调用我们服务端发布的wsdl文件呢?
1.调用一次WebService的本质:
1.客户端把调用方法参数,转换生成XML文档片段(SOAP消息,input消息,该文档片段必须符合WSDL定义的格式),通过网络,把XML文档片段传给服务器
2.服务器接收到XML文档片段,解析XML文档片段,提取其中的数据,并把数据转换调用WebService所需要的参数值。
3.服务器执行方法。
4.把执行方法得到的返回值,再次转换生成为XML文档片段(SOAP消息,output消息)——该文档片段必须符合WSDL定义的格式,通过网络,把XML文档片段传给客户端。
5.客户端接收到XML文档片段,解析XML文档片段,提取其中数据,并把数据转换调用WebService的返回值。
从上面调用本质来看,要一个语言支持WebService,唯一的要求是:该语言支持XML文档解析、生成、支持网络传输。
2.客户端调用方式:
客户端调用服务端方法总体来说有三种方式:
1)DII(Dynamic Invocation Interface)
采用直接调用方式,可以在程序中设置诸多的调用属性,使用较为灵活,但是调用过程却相对繁琐复杂,易造成代码膨胀且可重用性低,每次调用不同的Web Service都要重复进行大量编码。
这也是我们比较常用的一种方法,就是调用invoke方法,传入方法名和方法参数即可。
2)Stubs
JAX-RPC使用静态的Stub方式包装对底层接口的调用,从而提供一种更为简便的调用方式。使用该方式需要利用支持环境(比如Axis)所提供的工具根据WSDL预生成WebService客户端的实现代码。因此如果服务的WSDL发生变化,就必须重新生成新的客户端代码并进行重新部署。
该方法需要使用wsdl2java命令来预生成WebService客户端代码,为了支持该命令,需要安装一些环境。
3)Dynamic Proxy
动态代理(Dynamic Proxy)的方法实现对Web Service的动态调用,可以在运行时根据用户定义的Client端接口创建适配对象。从而避免了直接操作底层的接口,减少了客户端的冗余,屏蔽了调用相关的复杂性。
该方法主要在于客户端接口,该客户端接口需要继承java.rmi.Remote接口,然后将服务端的接口中的方法copy过来。
小结:
从发展历史角度来看,很容易理解他们的侧重点,Axis1最早,所以注重的只是简单的发布接口即可,之后随之Axis2对其进行了优化,可以支持自定义参数,但并不完善,所以CXF的出现对这一功能进行了完善并且适应了潮流,实现了与Spring的集成,跟这些比起来,EJB3中对于WebService的支持只需要使用一个@WebService即可完成,所以软件的开发是让使用者变傻,而我们学习这些是为了理解其原理和本质。