本文為原創(chuàng)，如需轉(zhuǎn)載，請(qǐng)注明作者和出處，謝謝！
上一篇：WebService大講堂之Axis2（2）：復(fù)合類型數(shù)據(jù)的傳遞
用Axis2實(shí)現(xiàn)Web Service，雖然可以將POJO類放在axis2\WEB-INF\pojo目錄中直接發(fā)布成Web Service，這樣做不需要進(jìn)行任何配置，但這些POJO類不能在任何包中。這似乎有些不方便，為此，Axis2也允許將帶包的POJO類發(fā)布成Web Service。
先實(shí)現(xiàn)一個(gè)POJO類，代碼如下：
package service;
public class MyService
{
public String getGreeting(String name)
{
return "您好 " + name;
}
public void update(String data)
{
System.out.println("<" + data + ">已經(jīng)更新");
}
}
這個(gè)類有兩個(gè)方法，這兩個(gè)方法都需要發(fā)布成Web Service方法。這種方式和直接放在pojo目錄中的POJO類不同。要想將MyService類發(fā)布成Web Service，需要一個(gè)services.xml文件，這個(gè)文件需要放在META-INF目錄中，該文件的內(nèi)容如下：
<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>元素用于發(fā)布Web Service，一個(gè)<service>元素只能發(fā)布一個(gè)WebService類，name屬性表示WebService名，如下面的URL可以獲得這個(gè)WebService的WSDL內(nèi)容：
http://localhost:8080/axis2/services/myService?wsdl
其中name屬性名就是上面URL中"?"和"/"之間的部分。
<description>元素表示當(dāng)前Web Service的描述，<parameter>元素用于設(shè)置WebService的參數(shù)，在這里用于設(shè)置WebService對(duì)應(yīng)的類名。在這里最值得注意的是<messageReceivers>元素，該元素用于設(shè)置處理WebService方法的處理器。例如，getGreeting方法有一個(gè)返回值，因此，需要使用可處理輸入輸出的RPCMessageReceiver類，而update方法沒有返回值，因此，需要使用只能處理輸入的RPCInOnlyMessageReceiver類。
使用這種方式發(fā)布WebService，必須打包成.aar文件，..aar文件實(shí)際上就是改變了擴(kuò)展名的.jar文件。在現(xiàn)在建立了兩個(gè)文件：MyService.java和services.xml。將MyService.java編譯，生成MyService.class。services.xml和MyService.class文件的位置如下：
D:\ws\service\MyService.class
D:\ws\META-INF\services.xml
在windows控制臺(tái)中進(jìn)入ws目錄，并輸入如下的命令生成.aar文件（實(shí)際上，.jar文件也可以發(fā)布webservice，但axis2官方文檔中建議使用.aar文件發(fā)布webservice）：
jar cvf ws.aar
.
最后將ws.aar文件復(fù)制到<Tomcat安裝目錄>\webapps\axis2\WEB-INF\services目錄中，啟動(dòng)Tomcat后，就可以調(diào)用這個(gè)WebService了。調(diào)用的方法和《WebService大講堂之Axis2（1）：用POJO實(shí)現(xiàn)0配置的WebService》所講的方法類似。
另外services.xml文件中也可以直接指定WebService類的方法，如可以用下面的配置代碼來發(fā)布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文件的內(nèi)容相同，但后面使用了<operation>元素來指定每一個(gè)WebService方法，并單獨(dú)指定了處理每一個(gè)方法的處理器。對(duì)于客戶端來說，調(diào)用使用這兩個(gè)services.xml文件發(fā)布的WebService并沒有太大我區(qū)別，只是使用第二個(gè)services.xml文件發(fā)布WebServices后，在使用wsdl2java命令或使用C#、delphi等生成客戶端的stub時(shí)，update方法的String類型被封裝在了update類中，在傳遞update方法的參數(shù)時(shí)需要建立update類的對(duì)象實(shí)例。而使用第一個(gè)services.xml文件發(fā)布的WebService在生成stub時(shí)直接可以為update方法傳遞String類型的參數(shù)。從這一點(diǎn)可以看出，這兩種方法生成的WSDL有一定的區(qū)別。但實(shí)際上，如果客戶端程序使用第一個(gè)services.xml文件發(fā)布的WebService生成stub類時(shí)（這時(shí)update方法的參數(shù)是String），在服務(wù)端又改為第二個(gè)services.xml文件來發(fā)布WebService，這時(shí)客戶端并不需要再重新生成stub類，而可以直接調(diào)用update方法。也就是說，服務(wù)端使用什么樣的方式發(fā)布WebService，對(duì)客戶端并沒有影響。
如果想發(fā)布多個(gè)WebService，可以使用<serviceGroup>元素，如再建立一個(gè)MyService1類，代碼如下：
package service
public class MyService1
{
public String getName()
{
return "bill";
}
}
在services.xml文件中可以使用如下的配置代碼來配置MyService和MyService1類：
<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>
下一篇：
WebService大講堂之Axis2(4)：二進(jìn)制文件傳輸
新浪微博：http://t.sina.com.cn/androidguy 昵稱：李寧_Lining