WebService大講堂之Axis2(6)：跨服務會話(Session)管理

本文為原創，如需轉載，請注明作者和出處，謝謝！

<a href="http://www.blogjava.net/nokiaguy/archive/2009/05/archive/2009/01/04/249805.html"></a>

    用Axis2實作Web Service，雖然可以将POJO類放在axis2/WEB-INF/pojo目錄中直接釋出成Web Service，這樣做不需要進行任何配置，但這些POJO類不能在任何包中。這似乎有些不友善，為此，Axis2也允許将帶包的POJO類釋出成Web Service。

    先實作一個POJO類，代碼如下：

&lt;!--

Code highlighting produced by Actipro CodeHighlighter (freeware)

http://www.CodeHighlighter.com/

--&gt;package service;

public class MyService

{

    public String getGreeting(String name)

    {

        return "您好 " + name;

    }

    public void update(String data)

        System.out.println("&lt;" + data + "&gt;已經更新");

}

這個類有兩個方法，這兩個方法都需要釋出成Web Service方法。這種方式和直接放在pojo目錄中的POJO類不同。要想将MyService類釋出成Web Service，需要一個services.xml檔案，這個檔案需要放在META-INF目錄中，該檔案的内容如下：

--&gt;&lt;service name="myService"&gt;

    &lt;description&gt;

        Web Service例子

    &lt;/description&gt;

    &lt;parameter name="ServiceClass"&gt;

        service.MyService  

    &lt;/parameter&gt;

    &lt;messageReceivers&gt;

        &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"

            class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /&gt;

        &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"

            class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /&gt;

    &lt;/messageReceivers&gt;

&lt;/service&gt;

其中&lt;service&gt;元素用于釋出Web Service，一個&lt;service&gt;元素隻能釋出一個WebService類，name屬性表示WebService名，如下面的URL可以獲得這個WebService的WSDL内容：

<a href="http://localhost:8080/axis2/services/myService?wsdl">http://localhost:8080/axis2/services/myService?wsdl</a>

其中name屬性名就是上面URL中"?"和"/"之間的部分。

&lt;description&gt;元素表示目前Web Service的描述，&lt;parameter&gt;元素用于設定WebService的參數，在這裡用于設定WebService對應的類名。在這裡最值得注意的是&lt;messageReceivers&gt;元素，該元素用于設定處理WebService方法的處理器。例如，getGreeting方法有一個傳回值，是以，需要使用可處理輸入輸出的RPCMessageReceiver類，而update方法沒有傳回值，是以，需要使用隻能處理輸入的RPCInOnlyMessageReceiver類。

使用這種方式釋出WebService，必須打包成.aar檔案，..aar檔案實際上就是改變了擴充名的.jar檔案。在現在建立了兩個檔案：MyService.java和services.xml。将MyService.java編譯，生成MyService.class。services.xml和MyService.class檔案的位置如下：

D:/ws/service/MyService.class

D:/ws/META-INF/services.xml

    在windows控制台中進入ws目錄，并輸入如下的指令生成.aar檔案（實際上，.jar檔案也可以釋出webservice，但axis2官方文檔中建議使用.aar檔案釋出webservice）：

jar cvf ws.aar

.

另外services.xml檔案中也可以直接指定WebService類的方法，如可以用下面的配置代碼來釋出WebService：

    &lt;operation name="getGreeting"&gt;

        &lt;messageReceiver class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /&gt;

    &lt;/operation&gt;

    &lt;operation name="update"&gt;

        &lt;messageReceiver

上面的配置代碼前面的部分和以前的services.xml檔案的内容相同，但後面使用了&lt;operation&gt;元素來指定每一個WebService方法，并單獨指定了處理每一個方法的處理器。對于用戶端來說，調用使用這兩個services.xml檔案釋出的WebService并沒有太大我差別，隻是使用第二個services.xml檔案釋出WebServices後，在使用wsdl2java指令或使用C#、delphi等生成用戶端的stub時，update方法的String類型被封裝在了update類中，在傳遞update方法的參數時需要建立update類的對象執行個體。而使用第一個services.xml檔案釋出的WebService在生成stub時直接可以為update方法傳遞String類型的參數。從這一點可以看出，這兩種方法生成的WSDL有一定的差別。但實際上，如果用戶端程式使用第一個services.xml檔案釋出的WebService生成stub類時（這時update方法的參數是String），在服務端又改為第二個services.xml檔案來釋出WebService，這時用戶端并不需要再重新生成stub類，而可以直接調用update方法。也就是說，服務端使用什麼樣的方式釋出WebService，對用戶端并沒有影響。

如果想釋出多個WebService，可以使用&lt;serviceGroup&gt;元素，如再建立一個MyService1類，代碼如下：

--&gt;package service

public class MyService1

    public String getName()  

    { 

        return "bill";

在services.xml檔案中可以使用如下的配置代碼來配置MyService和MyService1類：

--&gt;&lt;serviceGroup&gt;

    &lt;service name="myService"&gt;

        &lt;description&gt;

            Web Service例子

        &lt;/description&gt;

        &lt;parameter name="ServiceClass"&gt;

            service.MyService  

        &lt;/parameter&gt;

        &lt;messageReceivers&gt;

            &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"

                class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /&gt;

            &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"

                class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /&gt;

        &lt;/messageReceivers&gt;

    &lt;/service&gt;

    &lt;service name="myService1"&gt;

       &lt;/description&gt;

        &lt;parameter name="ServiceClass"&gt;

            service.MyService1  

        &lt;/parameter&gt;

         &lt;messageReceivers&gt;

           &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"

                class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /&gt;

           &lt;messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"

                class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver" /&gt;

&lt;/serviceGroup&gt;