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 可以找到：

三、部署axis2 war

解壓下載的axis2-1.6.2-war.zip 得到一個axis2.war檔案，將這個檔案丟到tomcat\webapps目錄，啟動tomcat
訪問http://localhost:8080/axis2

看到如下介面，部署成功。

四、編寫服務代碼

package com.xcy;/** * @author 肖純勇(Siuon) * @version 1.0 * @create 2012-7-19 下午8:23:49 */public class Axis2WB {/** * 提供了一個說Hello的服務 * @return */public String sayHello(String name){return "Hello "+name;}/** * 提供了一個做加法的服務 * @param a * @param b * @return */public int add(int a,int b){return a + b;}}

五、將服務代碼打包成arr檔案：

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

class file location：為剛剛寫的Axis2WB類所在工程的bin目錄

選擇skip wsdl

如果你的Axis2WB有引用jar包，則在這裡選擇。我寫的沒有，所以next

由於我們沒有編寫service.xml，所以勾選讓它自動產生，next

輸入服務名稱(隨意)、類全名、load、next

設定aar檔案名稱以及存放目錄(我是放在案頭)--Finish：

完成後，可以看到案頭上多了一個axis2wb.aar檔案，我們用winrar開啟：

有沒有感覺很眼熟？很像一個jar包、我們點擊META-INF目錄進去，可以看到外掛程式給我們產生的一個service.xml，開啟看看(是不是明白外掛程式做了些啥了)：

　　

六、發布

將axis2wb.aar檔案丟到之前部署的axis2應用的WEB-INF\services\目錄下面，重啟tomcat

再訪問http://localhost:8080/axis2/   點擊Service

看到，說明發布成功

七、產生用戶端代碼

你可以用jdk6內建的wsimport工具產生用戶端代碼：Java 6 開發 WebService

也可以通過axis2 的Eclipse外掛程式產生用戶端代碼：

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

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)。

產生完代碼後，你會發現報錯，原因是因為缺少相關的jar包。

解壓在第一步中下載的axis2 binary.zip  將解壓後的目錄中的lib下面的所有jar包，拷進來，添加到class path中：

8、調用Web服務

package test;import java.rmi.RemoteException;import com.xcy.Add;import com.xcy.AddResponse;import com.xcy.Axis2WB;import com.xcy.Axis2WBStub;import com.xcy.SayHello;import com.xcy.SayHelloResponse;/** * @author 肖純勇(Siuon) * @version 1.0 * @create 2012-7-19 下午9:18:23 */public class Test {public static void main(String[] args) throws RemoteException {//建立用戶端對象Axis2WB axis2wb = new Axis2WBStub();//new一個調用sayHello方法需要的參數SayHello，並且設定nameSayHello sayHello = new SayHello();sayHello.setName("Siuon");//調用web服務SayHelloResponse sayHelloResponse = axis2wb.sayHello(sayHello);//拿到返回結果System.out.println(sayHelloResponse.get_return());Add add = new Add();add.setA(5);add.setB(3);AddResponse addResponse = axis2wb.add(add);System.out.println(addResponse.get_return());}}

結果：

將Axis2開發的WebService發布到自己的應用中(補充)