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 .

???
最后將ws.aar文件復制到<Tomcat安裝目錄>\webapps\axis2\WEB-INF\services目錄中,啟動Tomcat后,就可以調用這個WebService了。調用的方法和《WebService大講堂之Axis2(1):用POJO實現0配置的WebService》所講的方法類似。

另外services.xml文件中也可以直接指定WebService類的方法,如可以用下面的配置代碼來發布WebService


<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類,代碼如下:

package?service
public?class?MyService1
{
????
public?String?getName()??
????{?
????????
return?"bill";
????}
}

services.xml文件中可以使用如下的配置代碼來配置MyServiceMyService1類:


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