应用Apache Axis2 实现Webservice发布
由于最近需要做webservice接口，所以google了一下，发现Apacle有个Axis2插件，一直觉得Apache的插件还是蛮好用的，于是决定应用Axis2来实现Webservice，第一次做webservice，呵呵有很多不懂的地方，所以记录下来留着以后备用。
首先访问Apache官网http://axis.apache.org/axis2/java/core/download.cgi下载Axis2最新的1.6.2的两个文件，axis2-1.6.2-bin和axis2-1.6.2-war，我这里用到了axis2的eclipse插件，所以同时下载了?axis2-eclipse-codegen-plugin-1.6.2.zip和axis2-eclipse-service-plugin-1.6.2.zip两个eclipse插件。
下载完这几个文件之后，需要将axis2的war文件复制到tomcat的wabapps目录下，重启Tomcat服务，浏览器输入axis2服务地址http://localhost:8082/axis2/，如果axis2服务没有问题，页面会显示如下效果，说明服务启动成功。
接下来在Eclipse中安装axis2插件，将下载的axis2-eclipse-codegen-plugin-1.6.2.zip和axis2-eclipse-service-plugin-1.6.2.zip文件解压，解压出来就是2个jar包，
将这两文件复制到Ecilpse的 plugins文件夹下，重启Eclipse，配置axis2的运行环境，如图，图中的路径F:\axis2-1.6.2就是下载的axis2-1.6.2-bin的解压目录。
点击file->new others->，如果插件安装成功，在窗口的列表中会显示如下的axis2的两个选项，
做好以上准备工作之后，接下来就要开始创建Webservice了。首先创建一个java工程，并创建一个Java类，很简单的一个类，只包含一个公共方法，如下
?
- package?com.jax.test;??
- ??
- import?com.jax.db.DataBase;??
- ??
- public?class?TestService?{??
- ??
- ????public?String?getData(String?id,String?name){??
- ????????return?DataBase.getData(id,name);?????????
- ????}??
- ??????
- }??
在服务类TestService中，有一个getData方法，最后发布服务之后，该方法就是暴露给外界访问webservice接口的方法。包含2个String参数和一个返回值，在方法中，
通过DataBase类的getData方法访问了Oracle数据库并返回数据。
?
编写完服务类之后，通过axis2的插件将服务打包成aar文件，复制到tomcat的webapps的axis2目录下的WEB-INF下的services文件夹下，打包过程如下
点击file->new others-> 在窗口中选择Axis2 Service Archiver选项，然后下一步如图，该步骤是选择class类的根目录，在bin目录下，包含了2个Class类文件，
com.jax.test.TestService和com.jax.db.DataBase，因为在TestService服务类中，关联了DataBase类，所以要选择根目录。
点击next ->如图所示 勾选Skip WSDL
?
点击next->选择服务所需的jar包，在这里因为连接了oracle数据库，所以选择了orache的驱动包
?
点击next-> 如图，勾选 图中的选项。
点击next-> 如图，输入服务名和服务类的全路径名，选择Search declare methods only，会显示要发布的服务方法。
输入打包aar文件的名称和输出路径，最后打包完成。
最后将打包好的aar文件复制到tomcat 的axis2的WEB-INF的services目录下，重启Tomcat服务，如图，发布的MyService服务
这样一个简单的webservice服务就发布完成了，有一点需要注意的是，和这个服务类相关的类需要打成jar包拷贝到axis服务的WEB-INF的lib目录下。
用Axis2创建调用webservice的客户端，创建java工程，引入以下axis2相关的jar包
?
axiom-api-1.2.11.jar
axiom-impl-1.2.11.jar
axis2-adb-1.5.5.jar
axis2-kernel-1.5.5.jar
axis2-transport-http-1.5.5.jar
axis2-transport-local-1.5.5.jar
commons-codec-1.3.jar
commons-httpclient-3.1.jar
commons-io.jar
commons-logging-1.1.1.jar
httpcore-4.0.jar
mail-1.4.jar
neethi-2.0.5.jar
wsdl4j-1.6.2.jar
XmlSchema-1.4.3.jar
创建调用服务类，应用axis2提供的类实现调用服务，代码如下：
- package?com.test;??
- ??
- import?java.util.Iterator;???
- import?javax.xml.namespace.QName;???
- import?org.apache.axiom.om.OMAttribute;???
- import?org.apache.axiom.om.OMElement;???
- import?org.apache.axis2.AxisFault;???
- import?org.apache.axis2.addressing.EndpointReference;???
- import?org.apache.axis2.client.Options;???
- import?org.apache.axis2.rpc.client.RPCServiceClient;???
- ??
- public?class?CallWebservice?{???
- ??
- public?String?getData(String?id,String?name)?{???
- ????String?result=null;???
- ??????????
- ????//webService的调用地址?????
- ????String?srvcUrl?=?"http://localhost:8082/axis2/services/MyService";???
- ????//操作的命名空间+“：”+操作名???
- ????QName?qname?=?new?QName("http://test.jax.com",?"getData");???
- ????//传递的参数对象集??
- ????Object?param[]?=?new?Object[]?{?id,name?};???
- ????try?{???
- ????????//实例化远程服务调用客户端对象???
- ????????RPCServiceClient?client?=?new?RPCServiceClient();???
- ????????//实例化Options对象??
- ????????Options?options?=?new?Options();???
- ????????//设置Options对象的连接终端地址??
- ????????options.setTo(new?EndpointReference(srvcUrl));???
- ????????//设置Options对象的操作事件对象???
- ????????options.setAction("urn:getData");???
- ????????//为远程服务调用客户端对象设置Options子对象???
- ????????client.setOptions(options);???
- ????????//传递参数，调用服务??
- ?????????OMElement?element?=?client.invokeBlocking(qname,?param);???
- ??????????
- ????????result=element.getFirstElement()?.getText();???
- ??????
- ????}???
- ????catch?(AxisFault?e)?{???
- ????????e.printStackTrace();???
- ????}???
- ????return?result;???
- }???
- ??
- //测试???
- public?static?void?main(String[]?args)?{???
- ??
- ????CallWebservice?client=new?CallWebservice();???
- ??????
- ????String?rs?=?client.getData("1","张三");???
- ?????System.out.println(rs);???
- }???
- }???
代码说明请看注释。
?
还有一种调用方式是通过axis2工具生成stub类，然后调用webservice，
如图
?其中-url参数指定了wsdl文件的路径，可以是本地路径，也可以是网络路径。-p参数指定了生成的Java类的包名，-o参数指定了生成的一系列文件保存的根目录。在执行完上面的命令后，读者就会发现在当前目录下多了个stub目录，在."stub"src"client目录可以找到一个MyServiceStub.java文件，该文件复杂调用WebService，然后可以在程序中直接使用这个类，通过stub调用webservice
代码如下：
?
- package?client;??
- ??
- import?java.rmi.RemoteException;??
- ??
- import?org.apache.axis2.AxisFault;??
- ??
- import?client.MyServiceStub.GetDataResponse;??
- ??
- public?class?CallService?{??
- ??
- ????public?static?void?main(String[]?args){??
- ????????//MyServiceStub中生成了一个getData(GetData?getData)的方法??
- ????????//该方法的内部实现了调用发布的webservice服务中的getData()方法??
- ??????????
- ????????//首先创建参数对象??
- ????????MyServiceStub.GetData?getData?=?new?MyServiceStub.GetData();??
- ????????//给参数赋值??
- ????????getData.setId("1");??
- ????????getData.setName("张三");??
- ??????????
- ????????try?{??
- ????????????//实例化stub类??
- ????????????MyServiceStub?stub?=?new?MyServiceStub();??
- ????????????try?{??
- ????????????????//调用服务方法??
- ????????????????GetDataResponse?rs?=?stub.getData(getData);??
- ????????????????//返回值为String???
- ????????????????String?str?=?rs.get_return();??
- ????????????????System.out.println(str);??
- ????????????}?catch?(RemoteException?e)?{??
- ????????????????//?TODO?Auto-generated?catch?block??
- ????????????????e.printStackTrace();??
- ????????????}??
- ????????}?catch?(AxisFault?e)?{??
- ????????????//?TODO?Auto-generated?catch?block??
- ????????????e.printStackTrace();??
- ????????}??
- ????}??
- }??