eclipse+webservice(axis2)開發實例

1.參考文獻：

1.利用Java編寫簡單的WebService實例  http://nopainnogain.iteye.com/blog/791525

2.Axis2與Eclipse整合開發Web Service  http://tech.ddvip.com/2009-05/1242968642120461.html

3.http://blog.csdn.net/lightao220/article/details/3489015

4.http://clq9761.iteye.com/blog/976029

5.使用Eclipse+Axis2+Tomcat構建Web Services應用（實例講解篇）

2.實例1（主要看到[2]）

2.1.系統功能: 

開發一個計算器服務CalculateService，這個服務包含加(plus)、減(minus)、乘(multiply)、除(divide)的操作。

2.2.開發前準備：

1. 安裝Eclipse-jee；
2. 下載最新版本的Axis2，網址http://axis.apache.org/axis2/java/core/download.cgi ，選擇Standard Binary Distribution的zip包，解壓縮得到的目錄名axis2-1.4.1，目錄內的文件結構如下：

2.3.開發前配置：

在Eclipse的菜單欄中，Window --> Preferences --> Web Service --> Axis2 Perferences,在Axis2 runtime location中選擇Axis2解壓縮包的位置，設置好後，點"OK"即行。（如圖）

2.4.開發Web Service:

（1）新建一個Java Project，命名爲"WebServiceTest1"
（2）新建一個class，命名爲"CalculateService"，完整代碼如下：

package edu.sjtu.webservice;
/**
 * 計算器運算
 * @author rongxinhua
 */
public class CalculateService {
    //加法
    public float plus(float x, float y) {
        return x + y;
    }
    //減法
    public float minus(float x, float y) {
        return x - y;
    }
    //乘法
    public float multiply(float x, float y) {
        return x * y;
    }
    //除法
    public float divide(float x, float y) {
        if(y!=0)
        {
            return x / y;
        }
        else
            return -1;
    }
}

（3）在"WebServiceTest1"項目上new --> other，找到"Web Services"下面的"Web Service"；

（4）下一步(next)，在出現的Web Services對象框，在Service implementation中點擊"Browse"，進入Browse Classes對象框，查找到我們剛纔寫的寫的CalculateService類。(如下圖)。點擊"ok",則回到Web Service話框。

（5）在Web Service對話框中，將Web Service type中的滑塊，調到"start service“的位置，將Client type中的滑塊調到"Test client"的位置。

（6）在Web Service type滑塊圖的右邊有個"Configuration"，點擊它下面的選項，進入Service　Deployment Configuration對象框，在這裏選擇相應的Server(我這裏用Tomcat6.0)和Web Service　runtime(選擇Apache Axis2)，如下圖：

（7）點OK後，則返回到Web Service對話框，同理，Client type中的滑塊右邊也有"Configuration"，也要進行相應的置，步驟同上。完成後，Next --> next即行。進入到Axis2 Web Service Java Bean Configuration，我們選擇Generate a default services.xml，如下圖所示：

（8）到了Server startup對話框，有個按鍵"start server"（如下圖），點擊它，則可啓動Tomcat服務器了。

（9）等啓完後，點擊"next -- > next"，一切默認即行，最後，點擊完成。最後，出現如下界面：（Web Service Explorer），我們在這裏便可測試我們的Web服務。（使用瀏覽器打開的話使用如下地址：http://127.0.0.1:19189/wse/wsexplorer/wsexplorer.jsp?org.eclipse.wst.ws.explorer=3）。如下圖所示：

注：在瀏覽器中打開Web Service Explorer（有時候在eclipse中關閉了webservice explorer，可以用這種方法打開）

首先登錄地址：http://127.0.0.1:19189/wse/wsexplorer/wsexplorer.jsp。然後在網頁右上角選擇Web Service Exoplorer標籤。然後輸入WSDL地址：http://localhost:8080/WebServiceTest1/services/CalculateService?wsdl 。這個wsdl地址就是我們剛纔發佈服務的那個wsdl。點擊go，如下圖所示：

然後就可以看到如下界面了：

（10）測試比較簡單，例如，我們選擇一個"plus"的Operation（必須是CalculateServiceSoap11Binding），出現下圖，在x的輸入框中輸入1，在y的輸入框中輸入2，點擊"go",便會在status欄中顯示結果3.0。其他方法的測試也類似。結果如上圖所示。

2.5.CalculateService客戶端調用程序

前面我們已經定義好了加減乘除的方法並將這些方法發佈爲服務，那麼現在要做的就是調用這些服務即可。客戶端調用程序如下代碼所示：CalculateServiceTest.java

package edu.sjtu.webservice.test;

import javax.xml.namespace.QName;
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 CalculateServiceTest {

    /**
     * @param args
     * @throws AxisFault
     */
    public static void main(String[] args) throws AxisFault {
        // TODO Auto-generated method stub

        // 使用RPC方式調用WebService
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();
        // 指定調用WebService的URL
        EndpointReference targetEPR = new EndpointReference(
                "http://localhost:8080/WebServiceTest1/services/CalculateService");
        options.setTo(targetEPR);

        // 指定要調用的計算機器中的方法及WSDL文件的命名空間：edu.sjtu.webservice。
        QName opAddEntry = new QName("http://webservice.sjtu.edu","plus");//加法
        QName opAddEntryminus = new QName("http://webservice.sjtu.edu","minus");//減法
        QName opAddEntrymultiply = new QName("http://webservice.sjtu.edu","multiply");//乘法
        QName opAddEntrydivide = new QName("http://webservice.sjtu.edu","divide");//除法
        // 指定plus方法的參數值爲兩個，分別是加數和被加數
        Object[] opAddEntryArgs = new Object[] { 1,2 };
        // 指定plus方法返回值的數據類型的Class對象
        Class[] classes = new Class[] { float.class };
        // 調用plus方法並輸出該方法的返回值
        System.out.println(serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs, classes)[0]);
        System.out.println(serviceClient.invokeBlocking(opAddEntryminus,opAddEntryArgs, classes)[0]);
        System.out.println(serviceClient.invokeBlocking(opAddEntrymultiply,opAddEntryArgs, classes)[0]);
        System.out.println(serviceClient.invokeBlocking(opAddEntrydivide,opAddEntryArgs, classes)[0]);

    }
}

運行結果：

3.0
-1.0
2.0
0.5

3.實例2.HelloService

（1）首先定義服務方法，代碼如下所示：

package edu.sjtu.webservice;

public class HelloService {
    public String sayHelloNew() {
        return "hello";
    }

    public String sayHelloToPersonNew(String name) {
        if (name == null) {
            name = "nobody";
        }
        return "hello," + name;
    }

    public void updateData(String data) {
        System.out.println(data + " 已更新。");
    }
}

（2）參考實例1將這個方法發佈爲服務。

（3）編寫客戶端代碼調用WebService（主要參考[5]）

本文例子與其他例子最大的不同就在這裏，其他例子一般需要根據剛纔的服務wsdl生成客戶端stub，然後通過stub來調用服務，這種方式顯得比較單一，客戶端必須需要stub存根才能夠訪問服務，很不方面。本例子的客戶端不採用stub方式，而是一種實現通用的調用方式，不需要任何客戶端存根即可訪問服務。只需要指定對於的web servce地址、操作名、參數和函數返回類型即可。代碼如下所示：

HelloServiceTest2.java

package edu.sjtu.webservice.test;

import javax.xml.namespace.QName;

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 HelloServiceTest2 {
    private RPCServiceClient serviceClient;
    private Options options;
    private EndpointReference targetEPR;

    public HelloServiceTest2(String endpoint) throws AxisFault {
        serviceClient = new RPCServiceClient();
        options = serviceClient.getOptions();
        targetEPR = new EndpointReference(endpoint);
        options.setTo(targetEPR);
    }

    public Object[] invokeOp(String targetNamespace, String opName,
            Object[] opArgs, Class<?>[] opReturnType) throws AxisFault,
            ClassNotFoundException {
        // 設定操作的名稱
        QName opQName = new QName(targetNamespace, opName);
        // 設定返回值
        // Class<?>[] opReturn = new Class[] { opReturnType };
        // 操作需要傳入的參數已經在參數中給定，這裏直接傳入方法中調用
        return serviceClient.invokeBlocking(opQName, opArgs, opReturnType);
    }

    /**
     * @param args
     * @throws AxisFault
     * @throws ClassNotFoundException
     */
    public static void main(String[] args) throws AxisFault,
            ClassNotFoundException {
        // TODO Auto-generated method stub
        final String endPointReference = "http://localhost:8080/WebServiceTest1/services/HelloService";
        final String targetNamespace = "http://webservice.sjtu.edu";
        HelloServiceTest2 client = new HelloServiceTest2(endPointReference);

        String opName = "sayHelloToPersonNew";
        Object[] opArgs = new Object[] { "My Friends" };
        Class<?>[] opReturnType = new Class[] { String[].class };

        Object[] response = client.invokeOp(targetNamespace, opName, opArgs,
                opReturnType);
        System.out.println(((String[]) response[0])[0]);
    }

}

運行該程序，點擊Run As->Java application，可以看到控制檯端口的輸出是：Hello, My Friends，表明客戶端調用成功。該例子最大的不同和優勢表現在客戶端的調用方式，或者說是發起服務調用的方式，雖然比起客戶端stub存根的方式，代碼稍多，但是這種方式統一，不需要生產stub存根代碼，解決了客戶端有很多類的問題。如果讀者對這些代碼進一步封裝，我想調用方式很簡單，只需要傳遞相關參數，這更好地說明了服務調用的優勢。而且這種方式更加簡單明瞭，一看便知具體含義。而不需要弄得stub類的一些機制。

（4）改寫客戶端調用服務的代碼

（3）中提到的客戶端應用代碼寫的略微有些繁雜，下面將上面的客戶端調用service程序進行改寫，簡潔了許多。代碼如下：

HelloServiceTest.java

import javax.xml.namespace.QName;
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 HelloServiceTest {
    public static void main(String args[]) throws AxisFault {
        // 使用RPC方式調用WebService
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();
        // 指定調用WebService的URL
        EndpointReference targetEPR = new EndpointReference("http://localhost:8080/WebServiceTest1/services/HelloService");
        options.setTo(targetEPR);

        // 指定要調用的sayHelloToPerson方法及WSDL文件的命名空間
        QName opAddEntry = new QName("http://webservice.sjtu.edu","sayHelloToPersonNew");
        // 指定sayHelloToPerson方法的參數值
        Object[] opAddEntryArgs = new Object[] { "xuwei" };
        // 指定sayHelloToPerson方法返回值的數據類型的Class對象
        Class[] classes = new Class[] { String.class };
        // 調用sayHelloToPerson方法並輸出該方法的返回值
        System.out.println(serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs, classes)[0]);
    }
}