Java程式設計師從笨鳥到菜鳥之（一百一十）一步一步學習webservice（四）Axis2開發webservice詳解
Axis2是Apache提供的一款第三方Web Services引擎，與其前身Apache Axis相比，axis2更加高效、模組化，也更面向於XML的組織。經過精心的設計，axis2提供了更加便利的模組新增功能。 基於新的體系結構進行了全新編寫，而且沒有采用 Axis 1.x 的常用程式碼。支援開發 Axis2 的動力是探尋模組化更強、靈活性更高和更有效的體系結構，這種體系結構可以很容易地插入到其他相關 Web 服務標準和協議（如 WS-Security、WS-ReliableMessaging 等）的實現中。Apache Axis2 是Axis的後續版本，是新一代的SOAP
在使用之前當然需要先安裝axis2相關的服務 ，安裝axis2服務之前當然要先下載相關安裝檔案。下載地址：
在下載相關檔案之前我們先來說一下有關於axis2的包 ：
關於axis2，官方提供了四種類型的包，分別為二進位制包、war包、文件包和原始檔包。其中的二進位制包包含了示例程式和一些jar包；war包是可以作為web應用部署到servlet container中的axis2
官方文件說使用axis2需要的資源：java5及以上、不小於11M的硬碟空間和隨便一個作業系統。另外為了把二進位制資料打包成war檔案，需要安裝不低於1.6.5的apache ant；為了構建原始碼包，需要安裝不低於maven2.0.7的maven。
OK，下面我們就一起來安裝一下axis2：
1.下載axis2 的war包。
2.解壓所下載的war包到tomcat目錄下的webapps下。
3.啟動tomcat。在webapps
Ok，安裝完畢，簡單吧。
安裝完axis2之後。下一步我們就可以借用它來開發我們的webservice程式了。
1.首先建立一個web project
2.建立服務類Helloworld
package com.bzu.csh;
public class HelloWorld {
public String getHello(String name) {
return "Hello， " + name + ".";
}
public String getWorld(String name) {
return "World," + name + ".";
}
public String getHelloWorld() {
return "Hello,World";
}
}3.修改web.xml，內容如下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<!-- 載入Axis -->
<servlet>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>4.把tomcat安裝目錄下的webapps/axis2/WEB-INF下的modules、service和conf檔案件拷至HelloWorld下的WEB-INF目錄下。把lib下的如下jar包也拷過去。然後在services下新建HelloWorld/META-INF路徑，META-INF下新建services.xml，內容如下：
<service name="HelloWorld">
<description>
HelloWorld Service Example
</description>
<parameter name="ServiceClass">
com.bzu.csh.HelloWorld
</parameter>
<operation name="getHello">
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
<operation name="getWorld">
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
<operation name="getHelloWorld">
<!-- 這裡要注意，當沒有返回值時才用
org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver，沒有引數還是用RPCMessageReceiver-->
<messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</operation>
</service> 下面我們來說一下這裡service.xml的配置詳解：
1.<service name="HelloWorld"> 這裡指定服務名稱。
2. <description>服務描述
3. <parameter name="ServiceClass"> 服務級引數
在services.xml檔案中，我們可以直接在service節點下定義引數，這些引數供訊息上下文(在執行時)、AxisService或者AxisOperation訪問。引數有一個必選引數和可選引數：引數名稱是必選引數。這裡的服務引數為指定服務類。
4. <operation name="sayHello">
服務級訊息接收器
Axis2中訊息接收器是特殊的處理器，是In路徑（請求路徑）中的最後一個處理器。Web服務中的每個操作都有他自己的訊息接收器，而且不同的操作可以有不同的訊息接收器。訊息接收器是依賴於訊息交換模式的,所以我們必須為不同的訊息交換模式指定不同的訊息接收器。
怎樣才能給所有的操作指定相同的訊息接收器呢？只要新增服務級訊息接收器即可。如此我們就不必在操作級別指定訊息接收器了。我們要做的是指定服務級訊息接收器。而在部署時，Axis2會自動給操作選擇正確的訊息接收器。這裡我們指定
Operation 級訊息接收器
前文描述瞭如何指定服務級訊息接收器。但是，我們也可以為不同的操作指定不同的訊息接收器，這需要在operation中指定messageReceiver標籤
最後說明一個編寫用於部署服務組的services.xml檔案的問題
要在單個服務包檔案中部署多個服務，服務組是一個便捷方法。當然，這些服務之間應該存在邏輯關係。用於服務組的services.xml檔案和用於單個服務的，它們之間唯一的區別就是根元素。用於服務組的，根元素是serviceGroup，我們可以在serviceGroup元素內部定義多個service元素。
<serviceGroup>
<service name=service1>
......
<service>
<service name=service2>
..........
</service>
</serviceGroup>
能看到服務資訊了。
下面我們就可以寫一個客戶端來呼叫我們寫的服務程式了。
package com.bzu.client;
import javax.xml.namespace.QName;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
public class ClientTest {
public static void main(String[] args) {
String url = "http://127.0.0.1:8080/Axis2Demo/services/HelloWorld";
String result = null;
try {
// 使用RPC方式呼叫WebService
RPCServiceClient serviceClient = new RPCServiceClient();
Options options = serviceClient.getOptions();
// 指定呼叫WebService的URL
EndpointReference targetEPR = new EndpointReference(url);
options.setTo(targetEPR);
// 在建立QName物件時，QName類的構造方法的第一個引數表示WSDL檔案的名稱空間名，也就是<wsdl:definitions>元素的targetNamespace屬性值
// // 指定要呼叫的getWorld方法及WSDL檔案的名稱空間.....
QName opAddEntry = new QName("http://csh.bzu.com", "getWorld");
//
// 指定getGreeting方法的引數值，如果有多個，繼續往後面增加即可，不用指定引數的名稱
Object[] opAddEntryArgs = new Object[] { "java" };
// 返回引數型別，這個和axis1有點區別
// invokeBlocking方法有三個引數，其中第一個引數的型別是QName物件，表示要呼叫的方法名；
// 第二個引數表示要呼叫的WebService方法的引數值，引數型別為Object[]；
// 第三個引數表示WebService方法的返回值型別的Class物件，引數型別為Class[]。
// 當方法沒有引數時，invokeBlocking方法的第二個引數值不能是null，而要使用new Object[]{}
// 如果被呼叫的WebService方法沒有返回值，應使用RPCServiceClient類的invokeRobust方法，
// 該方法只有兩個引數，它們的含義與invokeBlocking方法的前兩個引數的含義相同
// 指定getGreeting方法返回值的資料型別的Class物件.....
Class[] classes = new Class[] { String.class };
// 呼叫getGreeting方法並輸出該方法的返回值.......
result = (String) serviceClient.invokeBlocking(opAddEntry,
opAddEntryArgs, classes)[0];
System.out.println(result);
// 下面是呼叫getHello方法的程式碼，這些程式碼與呼叫getWorld方法的程式碼類似
// classes = new Class[] {String.class};
opAddEntry = new QName("http://csh.bzu.com", "getHello");
opAddEntryArgs = new Object[] { "曹勝歡" };
System.out.println(serviceClient.invokeBlocking(opAddEntry,
opAddEntryArgs, classes)[0]);
// 下面是呼叫getHelloWorld方法的程式碼
opAddEntry = new QName("http://csh.bzu.com", "getHelloWorld");
System.out.println(serviceClient.invokeBlocking(opAddEntry,
new Object[]{}, classes)[0]);
} catch (Exception e) {
e.printStackTrace();
}
}
}
執行結果：
各類的詳細運用都在註釋裡面解釋了。我想我就沒必要在重複說了。注意引數不要配置錯誤