本文為原創，如需轉載，請注明作者和出處，謝謝！
上一篇：WebService大講堂之Axis2(4)：二進制文件傳輸
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);
}
運行上面的代碼后，會輸出“成功登錄”信息。
下一篇：WebService大講堂之Axis2(6)：跨服務會話(Session)管理
新浪微博：http://t.sina.com.cn/androidguy 昵稱：李寧_Lining