WebService流行框架之Axis和CXF

转自:http://www.cnblogs.com/snake-hand/archive/2013/06/09/3129915.html

前言

上节课我们对WebService进行了简单的介绍,对于其所应用到的技术有了一定的了解。今天主要讲解下WebService的两个流行的框架Axis和CXF。

正题

一、服务端发布WebService

在讲解之前,我们先来看一下这篇博客主要讲解的内容:

WebService流行框架之Axis和CXF

每一种框架都有自己的特点,有自己的侧重,但是他们的共同之处在于对发布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的本质:

WebService流行框架之Axis和CXF

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即可完成,所以软件的开发是让使用者变傻,而我们学习这些是为了理解其原理和本质。

上一篇:如何在 ASP.Net Core 中使用 Serilog


下一篇:使用yum和iso镜像离线升级RedHat系统