WebService給人最直觀的感覺就是由一個個方法組成,并在客戶端通過SOAP協議調用這些方法。這些方法可能有返回值,也可能沒有返回值。雖然這樣可以完成一些工具,但這些被調用的方法是孤立的,當一個方法被調用后,在其他的方法中無法獲得這個方法調用后的狀態,也就是說無法保留狀態。

讀者可以想象,這對于一個完整的應用程序,無法保留狀態,就意味著只依靠WebService很難完成全部的工作。例如,一個完整的應用系統都需要進行登錄,這在Web應用中使用Session來保存用戶登錄狀態,而如果用WebService的方法來進行登錄處理,無法保存登錄狀態是非常令人尷尬的。當然,這也可以通過其他的方法來解決,如在服務端使用static變量來保存用戶狀態,并發送一個id到客戶端,通過在服務端和客戶端傳遞這個id來取得相應的用戶狀態。這非常類似于Web應用中通過SessionCookie來管理用戶狀態。但這就需要由開發人員做很多工作,不過幸好Axis2為我們提供了WebService狀態管理的功能。

使用Axis2來管理WebService的狀態基本上對于開發人員是透明的。在WebService類需要使用org.apache.axis2.context.MessageContextorg.apache.axis2.context.ServiceContext類來保存與獲得保存在服務端的狀態信息,這有些象使用HttpSession接口的getAttributesetAttribute方法獲得與設置Session域屬性。

除此之外,還需要修改services.xml文件的內容,為<service>元素加一個scope屬性,該屬性有四個可取的值:Application, SOAPSession, TransportSession, Request,不過要注意一下,雖然Axis2的官方文檔將這四個值的單詞首字母和縮寫字母都寫成了大寫,但經筆者測試,必須全部小寫才有效,也就是這四個值應為:applicationsoapsessiontransportsessionrequest,其中requestscope屬性的默認值。讀者可以選擇使用transportsessionapplication分別實現同一個WebService類和跨WebService類的會話管理。

在客戶端需要使用setManageSession(true)打開Session管理功能。

綜上所述,實現同一個WebServiceSession管理需要如下三步:

1.?使用MessageContextServiceContext獲得與設置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類中有兩個方法:logingetLoginMsg,如果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);
}

運行上面的代碼后,會輸出“成功登錄”信息。