【原創】WebService大講堂之Axis2(3):使用services.xml檔案釋出WebService

銀河使者發表於2009-01-21

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

    用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/

--&gtpackage 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/

--&gt<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>

其中元素用於釋出Web Service,一個元素只能釋出一個WebService類,name屬性表示WebService名,如下面的URL可以獲得這個WebServiceWSDL內容:

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

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

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

   
最後將ws.aar檔案複製到安裝目錄>\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/

--&gt<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檔案的內容相同,但後面使用了元素來指定每一個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,可以使用元素,如再建立一個MyService1類,程式碼如下:

<!--

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

--&gtpackage service
public class MyService1
{
    
public String getName()  
    { 
        
return "bill";
    }
}

services.xml檔案中可以使用如下的配置程式碼來配置MyServiceMyService1類:


<!--

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

--&gt<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>

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/12921506/viewspace-543031/,如需轉載,請註明出處,否則將追究法律責任。

相關文章