使用services.xml檔案釋出WebService

職業驅魔師發表於2013-07-24

使用services.xml檔案發WebService

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

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目錄中,該檔案的內容如下:

<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可以獲得這個WebServiceWSDL內容:

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.javaservices.xml。將MyService.java編譯,生成MyService.classservices.xmlMyService.class檔案的位置如下:

D:\ws\service\MyService.class

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

windows控制檯中進入ws目錄,並輸入如下的命令生成.aar檔案(實際上,.jar檔案也可以釋出webservice,但axis2官方文件中建議使用.aar檔案釋出webservice):

jar cvf ws.aar .    jar cvf AxisTest.aar . 

最後將ws.aar檔案複製到<Tomcat安裝目錄>\webapps\axis2\WEB-INF\services目錄中

相關文章