WebService給人最直觀的感覺就是由一個個方法組成，并在客戶端通過SOAP協(xié)議調(diào)用這些方法。這些方法可能有返回值，也可能沒有返回值。雖然這樣可以完成一些工具，但這些被調(diào)用的方法是孤立的，當(dāng)一個方法被調(diào)用后，在其他的方法中無法獲得這個方法調(diào)用后的狀態(tài)，也就是說無法保留狀態(tài)。
讀者可以想象，這對于一個完整的應(yīng)用程序，無法保留狀態(tài)，就意味著只依靠WebService很難完成全部的工作。例如，一個完整的應(yīng)用系統(tǒng)都需要進(jìn)行登錄，這在Web應(yīng)用中使用Session來保存用戶登錄狀態(tài)，而如果用WebService的方法來進(jìn)行登錄處理，無法保存登錄狀態(tài)是非常令人尷尬的。當(dāng)然，這也可以通過其他的方法來解決，如在服務(wù)端使用static變量來保存用戶狀態(tài)，并發(fā)送一個id到客戶端，通過在服務(wù)端和客戶端傳遞這個id來取得相應(yīng)的用戶狀態(tài)。這非常類似于Web應(yīng)用中通過Session和Cookie來管理用戶狀態(tài)。但這就需要由開發(fā)人員做很多工作，不過幸好Axis2為我們提供了WebService狀態(tài)管理的功能。
使用Axis2來管理WebService的狀態(tài)基本上對于開發(fā)人員是透明的。在WebService類需要使用org.apache.axis2.context.MessageContext和org.apache.axis2.context.ServiceContext類來保存與獲得保存在服務(wù)端的狀態(tài)信息，這有些象使用HttpSession接口的getAttribute和setAttribute方法獲得與設(shè)置Session域?qū)傩浴?/span>
除此之外，還需要修改services.xml文件的內(nèi)容，為<service>元素加一個scope屬性，該屬性有四個可取的值：Application, SOAPSession, TransportSession, Request，不過要注意一下，雖然Axis2的官方文檔將這四個值的單詞首字母和縮寫字母都寫成了大寫，但經(jīng)筆者測試，必須全部小寫才有效，也就是這四個值應(yīng)為：application、soapsession、transportsession、request，其中request為scope屬性的默認(rèn)值。讀者可以選擇使用transportsession和application分別實(shí)現(xiàn)同一個WebService類和跨WebService類的會話管理。
在客戶端需要使用setManageSession(true)打開Session管理功能。
綜上所述，實(shí)現(xiàn)同一個WebService的Session管理需要如下三步：
1.?使用MessageContext和ServiceContext獲得與設(shè)置key-value對。
2.?為要進(jìn)行Session管理的WebService類所對應(yīng)的<service>元素添加一個scope屬性，并將該屬性值設(shè)為transportsession。
3.?在客戶端使用setManageSession(true)打開Session管理功能。
下面是一個在同一個WebService類中管理Session的例子。
先建立一個WebService類，代碼如下：
package
?service;
import
?org.apache.axis2.context.ServiceContext;
import
?org.apache.axis2.context.MessageContext;
public
?
class
?LoginService
{
????
public
?
boolean
?login(String?username,?String?password)
????{
????????
if
(
"
bill
"
.equals(username)?
&&
?
"
1234
"
.equals(password))
????????{
????????????
//
??第1步：設(shè)置key-value對
????????????MessageContext?mc?
=
?MessageContext.getCurrentMessageContext();
????????????ServiceContext?sc?
=
?mc.getServiceContext();
????????????sc.setProperty(
"
login
"
,?
"
成功登錄
"
);????
????????????
return
?
true
;
????????}
????????
else
????????{
????????????
return
?
false
;
????????}
????}
????
public
?String?getLoginMsg()
????{
????????
//
??第1步：獲得key-value對中的value
????????MessageContext?mc?
=
?MessageContext.getCurrentMessageContext();
????????ServiceContext?sc?
=
?mc.getServiceContext();
????????
return
?(String)sc.getProperty(
"
login
"
);????
????}
}
在LoginService類中有兩個方法：login和getLoginMsg，如果login方法登錄成功，會將“成功登錄”字符串保存在ServiceContext對象中。如果在login方法返回true后調(diào)用getLoginMsg方法，就會返回“成功登錄”。
下面是LoginService類的配置代碼（services.xml）：
<!--
??第2步：添加scope屬性??
-->
<
service?
name
="loginService"
?scope
="transportsession"
>
????
<
description
>
????????登錄服務(wù)
????????
</
description
>
????
<
parameter?
name
="ServiceClass"
>
????????service.LoginService
????????
</
parameter
>
????
<
messageReceivers
>
????????
<
messageReceiver?
mep
="http://www.w3.org/2004/08/wsdl/in-out"
????????????class
="org.apache.axis2.rpc.receivers.RPCMessageReceiver"
?
/>
????
</
messageReceivers
>
</
service
>
使用如下的命令生成客戶端使用的stub類：
%AXIS2_HOME%\bin\wsdl2java?-uri?http://localhost:
8080
/axis2/services/loginService?wsdl?-p?client?-s?-o?stub
在stub\src\client目錄中生成了一個LoginServiceStub.java類，在該類中找到如下的構(gòu)造句方法：
public
?LoginServiceStub(org.apache.axis2.context.ConfigurationContext?configurationContext,
????????java.lang.String?targetEndpoint,?
boolean
?useSeparateListener)
????????
throws
?org.apache.axis2.AxisFault?
{
????
?
??? _serviceClient.getOptions().setSoapVersionURI(
???????????????????????????????? org.apache.axiom.soap.SOAP12Constants.SOAP_ENVELOPE_NAMESPACE_URI);
}
在該方法中最后添加如下的代碼：
//
??第3步：打開客戶端的Session管理功能
_serviceClient.getOptions().setManageSession(
true
);
下面的客戶端代碼使用LoginServiceStub對象訪問了剛才建立的WebService：
LoginServiceStub?stub?
=
?
new
?LoginServiceStub();
LoginServiceStub.Login?login?
=
?
new
?LoginServiceStub.Login();
login.setUsername(
"
bill
"
);
login.setPassword(
"
1234
"
);
if
(stub.login(login).local_return)
{
????System.out.println(stub.getLoginMsg().local_return);
}
運(yùn)行上面的代碼后，會輸出“成功登錄”信息。