在看下面文章之前,可以看一下這一篇文章點擊打開鏈接,寫的非常好,是我在學習session管理的時候在網上看到的,就轉載來了。
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 session;
- 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">
- session.LoginService
- </parameter>
- <messageReceivers>
- <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
- class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
- </messageReceivers>
- </service>
接下來就是生成stub類,目錄中生成了一個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);
在這個環節,由於stub類一般情況下都是上千行,所以我們可以使用快捷方式,ctrl+O來找方法,當然也可以用高級的ctrl+H
下面的客戶端代碼使用LoginServiceStub對象訪問了剛纔建立的WebService:
- package session;
- import java.rmi.RemoteException;
- public class LoginStubClient {
- public static void main(String[] args) throws RemoteException {
- LoginServiceStub lss = new LoginServiceStub();
- LoginServiceStub.GetLoginMsg glm = new LoginServiceStub.GetLoginMsg();
- LoginServiceStub.Login login = new LoginServiceStub.Login();
- login.setUsername("bill");
- login.setPassword("1234");
- if(lss.login(login).local_return){
- System.out.println(lss.getLoginMsg(glm).local_return);
- }
- }
- }
運行結果