WebService給人最直觀的感覺就是由一個個方法組成,并在客戶端通過SOAP協議調用這些方法。這些方法可能有返回值,也可能沒有返回值。雖然這樣可以完成一些工具,但這些被調用的方法是孤立的,當一個方法被調用后,在其他的方法中無法獲得這個方法調用后的狀態,也就是說無法保留狀態。
讀者可以想象,這對于一個完整的應用程序,無法保留狀態,就意味著只依靠WebService很難完成全部的工作。例如,一個完整的應用系統都需要進行登錄,這在Web應用中使用Session來保存用戶登錄狀態,而如果用WebService的方法來進行登錄處理,無法保存登錄狀態是非常令人尷尬的。當然,這也可以通過其他的方法來解決,如在服務端使用static變量來保存用戶狀態,并發送一個id到客戶端,通過在服務端和客戶端傳遞這個id來取得相應的用戶狀態。這非常類似于Web應用中通過Session和Cookie來管理用戶狀態。但這就需要由開發人員做很多工作,不過幸好Axis2為我們提供了WebService狀態管理的功能。
使用Axis2來管理WebService的狀態基本上對于開發人員是透明的。在WebService類需要使用org.apache.axis2.context.MessageContext和org.apache.axis2.context.ServiceContext類來保存與獲得保存在服務端的狀態信息,這有些象使用HttpSession接口的getAttribute和setAttribute方法獲得與設置Session域屬性。
除此之外,還需要修改services.xml文件的內容,為<service>元素加一個scope屬性,該屬性有四個可取的值:Application, SOAPSession, TransportSession, Request,不過要注意一下,雖然Axis2的官方文檔將這四個值的單詞首字母和縮寫字母都寫成了大寫,但經筆者測試,必須全部小寫才有效,也就是這四個值應為:application、soapsession、transportsession、request,其中request為scope屬性的默認值。讀者可以選擇使用transportsession和application分別實現同一個WebService類和跨WebService類的會話管理。
在客戶端需要使用setManageSession(true)打開Session管理功能。
綜上所述,實現同一個WebService的Session管理需要如下三步:
1.?使用MessageContext和ServiceContext獲得與設置key-value對。
2.?為要進行Session管理的WebService類所對應的<service>元素添加一個scope屬性,并將該屬性值設為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步:設置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后調用getLoginMsg方法,就會返回“成功登錄”。
下面是LoginService類的配置代碼(services.xml):
<!--
??第2步:添加scope屬性??
-->
<
service?
name
="loginService"
?scope
="transportsession"
>
????
<
description
>
????????登錄服務
????????
</
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類,在該類中找到如下的構造句方法:
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);
}
運行上面的代碼后,會輸出“成功登錄”信息。