Apache axis2 + Eclipse 开发 WebService

一、简介

Apache Axis2是下一代 Apache Axis。Axis2 虽然由 Axis 1.x 处理程序模型提供支持,但它具有更强的灵活性并可扩展到新的体系结构。Axis2 基于新的体系结构进行了全新编写,而且没有采用 Axis 1.x 的常用代码。支持开发 Axis2 的动力是探寻模块化更强、灵活性更高和更有效的体系结构,这种体系结构可以很容易地插入到其他相关 Web 服务标准和协议(如 WS-Security、WS-ReliableMessaging 等)的实现中。Apache Axis2 是Axis的后续版本,是新一代的SOAP引擎。 官方网站:http://axis.apache.org/axis2/java/core/index.html


二、下载

Apache Axis2 下载页面:http://axis.apache.org/axis2/java/core/download.cgi (当前最新版本1.6.2)

Apache Axis2 Binary Distribution(1.6.2):http://mirror.bjtu.edu.cn/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip

WAR Distribution:http://mirror.bjtu.edu.cn/apache//axis/axis2/java/core/1.6.2/axis2-1.6.2-war.zip

Eclipse 插件:

Service Archive Wizard - Eclipse Plug-in(用来将服务代码打包成后缀名为.aar文件的插件):

http://www.apache.org/dyn/mirrors/mirrors.cgi/axis/axis2/java/core/1.6.2/axis2-eclipse-service-plugin-1.6.2.zip

Code Generator Wizard - Eclipse Plug-in(用来将服务代码生成wsdl文件以及解析将wsdl文件生成客户端代码的插件):

http://www.apache.org/dyn/mirrors/mirrors.cgi/axis/axis2/java/core/1.6.2/axis2-eclipse-codegen-plugin-1.6.2.zip

安装插件:

我用的是MyEclipse10,以我的环境为例:将两个插件解压后放到D:\sdk\MyEclipse\MyEclipse 10\dropins目录下面,启动MyEclipse

File - New - Other 可以找到:

Apache axis2 + Eclipse 开发 WebService_第1张图片

三、部署axis2 war

解压下载的axis2-1.6.2-war.zip 得到一个axis2.war文件,将这个文件丢到tomcat\webapps目录,启动tomcat 访问http://localhost:8080/axis2

看到如下界面,部署成功。

Apache axis2 + Eclipse 开发 WebService_第2张图片


四、编写服务代码

[java]  view plain copy
  1. package com.xcy;  
  2.   
  3. /** 
  4.  * @author 肖纯勇(Siuon) 
  5.  * @version 1.0 
  6.  * @create 2012-7-19 下午8:23:49 
  7.  */  
  8. public class Axis2WB {  
  9.     /** 
  10.      * 提供了一个说Hello的服务 
  11.      * @return 
  12.      */  
  13.     public String sayHello(String name){  
  14.         return "Hello "+name;  
  15.     }  
  16.       
  17.     /** 
  18.      * 提供了一个做加法的服务 
  19.      * @param a 
  20.      * @param b 
  21.      * @return 
  22.      */  
  23.     public int add(int a,int b){  
  24.         return a + b;  
  25.     }  
  26.       
  27. }  
五、 将服务代码打包成arr文件:

Eclipse菜单- New - File - Other -Axis2 Service Archiver

Apache axis2 + Eclipse 开发 WebService_第3张图片

class file location:为刚刚写的Axis2WB类所在工程的bin目录

Apache axis2 + Eclipse 开发 WebService_第4张图片

选择skip wsdl

Apache axis2 + Eclipse 开发 WebService_第5张图片

如果你的Axis2WB有引用jar包,则在这里选择。我写的没有,所以next

Apache axis2 + Eclipse 开发 WebService_第6张图片

由于我们没有编写service.xml,所以勾选让它自动生成,next

Apache axis2 + Eclipse 开发 WebService_第7张图片

输入服务名称(随意)、类全名、load、next

Apache axis2 + Eclipse 开发 WebService_第8张图片

设置aar文件名以及存放目录(我是放在桌面)--Finish:

Apache axis2 + Eclipse 开发 WebService_第9张图片

完成后,可以看到桌面上多了一个axis2wb.aar文件,我们用winrar打开:

Apache axis2 + Eclipse 开发 WebService_第10张图片

有没有感觉很眼熟?很像一个jar包、我们点击META-INF目录进去,可以看到插件给我们生成的一个service.xml,打开看看(是不是明白插件做了些啥了):

  Apache axis2 + Eclipse 开发 WebService_第11张图片


六、发布

将axis2wb.aar文件丢到之前部署的axis2应用的WEB-INF\services\目录下面,重启tomcat

再访问http://localhost:8080/axis2/   点击Service

Apache axis2 + Eclipse 开发 WebService_第12张图片

Apache axis2 + Eclipse 开发 WebService_第13张图片Apache axis2 + Eclipse 开发 WebService_第14张图片

看到上图,说明发布成功


七、生成客户端代码

你可以用jdk6自带的wsimport工具生成客户端代码:Java 6 开发 WebService

也可以通过axis2 的Eclipse插件生成客户端代码:

Eclipse菜单-File-New-Other-Axis2 Code Generator

Apache axis2 + Eclipse 开发 WebService_第15张图片

Generate Java source code from a WSDL file:根据WSDL生成webservice客户端的java代码。(在这里,我们选择这个)
Generate a WSDL from a Java source file   :根据一个java源文件生成wsdl文件(这个源文件是打算发布成Web服务的java源文件,例如本demo中的Axis2WB.java)。

Apache axis2 + Eclipse 开发 WebService_第16张图片

Apache axis2 + Eclipse 开发 WebService_第17张图片

Apache axis2 + Eclipse 开发 WebService_第18张图片Apache axis2 + Eclipse 开发 WebService_第19张图片

生成完代码后,你会发现报错,原因是因为缺少相关的jar包。

解压在第一步中下载的axis2 binary.zip  将解压后的目录中的lib下面的所有jar包,拷进来,添加到class path中:

Apache axis2 + Eclipse 开发 WebService_第20张图片



8、调用Web服务

[java]  view plain copy
  1. package test;  
  2.   
  3. import java.rmi.RemoteException;  
  4.   
  5. import com.xcy.Add;  
  6. import com.xcy.AddResponse;  
  7. import com.xcy.Axis2WB;  
  8. import com.xcy.Axis2WBStub;  
  9. import com.xcy.SayHello;  
  10. import com.xcy.SayHelloResponse;  
  11.   
  12. /** 
  13.  * @author 肖纯勇(Siuon) 
  14.  * @version 1.0 
  15.  * @create 2012-7-19 下午9:18:23 
  16.  */  
  17. public class Test {  
  18.     public static void main(String[] args) throws RemoteException {  
  19.         //创建客户端对象  
  20.         Axis2WB axis2wb = new Axis2WBStub();  
  21.           
  22.         //new一个调用sayHello方法需要的参数SayHello,并且设置name  
  23.         SayHello sayHello = new SayHello();  
  24.         sayHello.setName("Siuon");  
  25.         //调用web服务  
  26.         SayHelloResponse sayHelloResponse = axis2wb.sayHello(sayHello);  
  27.         //拿到返回结果  
  28.         System.out.println(sayHelloResponse.get_return());  
  29.           
  30.           
  31.         Add add = new Add();  
  32.         add.setA(5);  
  33.         add.setB(3);  
  34.         AddResponse addResponse = axis2wb.add(add);  
  35.         System.out.println(addResponse.get_return());  
  36.     }  
  37. }  

结果:

 

将Axis2开发的WebService发布到自己的应用中(补充)


在Tomcat\webapps目录下新建如下目录(我这里只是一个demo,所以就怎样简单就怎样做了):

[plain]  view plain copy
  1. myapp  
  2.     WEB-INF  
  3.         services  
  4.             axis2wb.aar  
  5.         lib  
  6.             axis2-bin.zip解压后的lib下的所有jar包  
  7.         web.xml  

web.xml

[html]  view plain copy
  1. <?xml version="1.0" encoding="ISO-8859-1"?>  
  2. <web-app>  
  3.     <servlet>  
  4.         <servlet-name>AxisServlet</servlet-name>  
  5.         <display-name>Apache-Axis Servlet</display-name>  
  6.         <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>  
  7.     </servlet>  
  8.       
  9.     <servlet-mapping>  
  10.         <servlet-name>AxisServlet</servlet-name>  
  11.         <url-pattern>/servlet/AxisServlet</url-pattern>  
  12.     </servlet-mapping>  
  13.   
  14.     <servlet-mapping>  
  15.         <servlet-name>AxisServlet</servlet-name>  
  16.         <url-pattern>*.jws</url-pattern>  
  17.     </servlet-mapping>  
  18.   
  19.     <servlet-mapping>  
  20.         <servlet-name>AxisServlet</servlet-name>  
  21.         <url-pattern>/services/*</url-pattern>  
  22.     </servlet-mapping>  
  23.   
  24. </web-app>  

允许tomcat后,访问:http://localhost:8080/myapp/services/Axis2WB?wsdl

Apache axis2 + Eclipse 开发 WebService_第21张图片


你可能感兴趣的:(Apache axis2 + Eclipse 开发 WebService)