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

geekori發表於2009-05-11
Web會話Session

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

上一篇：WebService大講堂之Axis2(5)：會話（Session）管理


    用Axis2實現Web Service，雖然可以將POJO類放在axis2/WEB-INF/pojo目錄中直接釋出成Web Service，這樣做不需要進行任何配置，但這些POJO類不能在任何包中。這似乎有些不方便，為此，Axis2也允許將帶包的POJO類釋出成Web Service。
    先實現一個POJO類，程式碼如下：

<!–

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

–>package service;

public class MyService
{
    public String getGreeting(String name)
    {
        return “您好 “ + name;
    }
    public void update(String data)
    {
        System.out.println(“<“ + data + “>已經更新“);
    }
}

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

<!–

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

–><service name=”myService”>
    <description>
        Web Service例子
    </description>
    <parameter name=”ServiceClass”>
        service.MyService  
    </parameter>
    <messageReceivers>
        <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-out”
            class=”org.apache.axis2.rpc.receivers.RPCMessageReceiver” />
        <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-only”
            class=”org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver” />
    </messageReceivers>
</service>

其中<service>元素用於釋出Web Service，一個<service>元素只能釋出一個WebService類，name屬性表示WebService名，如下面的URL可以獲得這個WebService的WSDL內容：

http://localhost:8080/axis2/services/myService?wsdl

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

<description>元素表示當前Web Service的描述，<parameter>元素用於設定WebService的引數，在這裡用於設定WebService對應的類名。在這裡最值得注意的是<messageReceivers>元素，該元素用於設定處理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
.

    最後將ws.aar檔案複製到<Tomcat安裝目錄>/webapps/axis2/WEB-INF/services目錄中，啟動Tomcat後，就可以呼叫這個WebService了。呼叫的方法和《WebService大講堂之Axis2（1）：用POJO實現0配置的WebService》所講的方法類似。

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

<!–

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

–><service name=”myService”>
    <description>
        Web Service例子
    </description>
    <parameter name=”ServiceClass”>
        service.MyService  
    </parameter>
    <operation name=”getGreeting”>
        <messageReceiver class=”org.apache.axis2.rpc.receivers.RPCMessageReceiver” />
    </operation>
    <operation name=”update”>
        <messageReceiver
            class=”org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver” />
    </operation>
</service>

上面的配置程式碼前面的部分和以前的services.xml檔案的內容相同，但後面使用了<operation>元素來指定每一個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，可以使用<serviceGroup>元素，如再建立一個MyService1類，程式碼如下：

<!–

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

–>package service
public class MyService1
{
    public String getName()  
    { 
        return “bill“;
    }
}

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

<!–

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

–><serviceGroup>
    <service name=”myService”>
        <description>
            Web Service例子
        </description>
        <parameter name=”ServiceClass”>
            service.MyService  
        </parameter>
        <messageReceivers>
            <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-out”
                class=”org.apache.axis2.rpc.receivers.RPCMessageReceiver” />
            <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-only”
                class=”org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver” />
        </messageReceivers>
    </service>
    <service name=”myService1″>
        <description>
            Web Service例子
       </description>
        <parameter name=”ServiceClass”>
            service.MyService1  
        </parameter>
         <messageReceivers>
           <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-out”
                class=”org.apache.axis2.rpc.receivers.RPCMessageReceiver” />
           <messageReceiver mep=”http://www.w3.org/2004/08/wsdl/in-only”
                class=”org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver” />
        </messageReceivers>
    </service>
</serviceGroup>

相關文章