WebService大讲堂之Axis2(5)：会话Session管理

时间：2020-10-06分类：WebService作者：编程之家

@H_502_0@

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;
org.apache.axis2.context.MessageContext;
public class LoginService
{
     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
        {
             false ;
        }
    }
     String getLoginMsg()
    {
           第1步：获得key-value对中的value         MessageContext mc MessageContext.getCurrentMessageContext();
        ServiceContext sc mc.getServiceContext();
         (String)sc.getProperty( );
    }
}

在LoginService 类中有两个方法：login 和getLoginMsg ，如果login 方法登录成功，会将“成功登录”字符串保存在ServiceContext 对象中。如果在login 方法返回true 后调用getLoginMsg 方法，就会返回“成功登录”。

下面是LoginService 类的配置代码（services.xml ）：

< service name ="loginService" scope ="transportsession" >
     description
        登录服务
         </ parameter ="ServiceClass"
        service.LoginService
         parameter messageReceivers
         messageReceiver mep ="http://www.w3.org/2004/08/wsdl/in-out"
            class ="org.apache.axis2.rpc.receivers.RPcmessageReceiver" /> service

使用如下的命令生成客户端使用的stub 类：

%AXIS2_HOME%\bin\wsdl2java -uri http://localhost: 8080 /axis2/services/loginService?wsdl -p client -s -o stub

在stub\src\client 目录中生成了一个LoginServiceStub.java 类，在该类中找到如下的构造句方法：

LoginServiceStub(org.apache.axis2.context.ConfigurationContext configurationContext,
        java.lang.String targetEndpoint,0)"> useSeparateListener)
         throws org.apache.axis2.AxisFault
{

_serviceClient.getoptions().setSoapVersionURI(
org.apache.axiom.soap.soAP12Constants.soAP_ENVELOPE_NAMESPACE_URI);
}

在该方法中最后添加如下的代码：

第3步：打开客户端的Session管理功能 _serviceClient.getoptions().setManageSession( );

下面的客户端代码使用LoginServiceStub 对象访问了刚才建立的WebService ：

LoginServiceStub stub new LoginServiceStub();
LoginServiceStub.Login login LoginServiceStub.Login();
login.setUsername( );
login.setPassword( );
(stub.login(login).local_return)
{
System.out.println(stub.getLoginMsg().local_return);
}

运行上面的代码后，会输出“成功登录”信息。

本文出自 “李宁的极客世界” 博客，请务必保留此出处http://www.voidcn.com/article/p-ktmuqorw-bkp.html

@H_502_0@