WebService大讲堂之Axis2(6)：跨服务会话(Session)管理

在 《WebService大讲堂之Axis2(5)：会话（Session）管理》 一文中介绍了如何使用Axis2 来管理同一个服务的会话，但对于一个复杂的系统，不可能只有一个WebService 服务，例如，至少会有一个管理用户的WebService （用户登录和注册）以及处理业务的WebService 。象这种情况，就必须在多个WebService 服务之间共享会话状态，也称为跨服务会话(Session) 管理。实现跨服务会话管理与实现同一个服务的会话管理的步骤类似，但仍然有一些差别，实现跨服务会话管理的步骤如下：

实现跨服务的Session 管理需要如下三步：

1.? 使用MessageContext 和 ServiceGroupContext 获得与设置key-value 对。

2.? 为要进行Session 管理的WebService 类所对应的<service> 元素添加一个scope 属性，并将该属性值设为 application 。

3.? 在客户端使用setManageSession(true) 打开Session 管理功能。

从上面的步骤可以看出，实现跨服务会话管理与实现同一个服务的会话管理在前两步上存在着差异，而第3 步是完全一样的。下面是一个跨服务的会话管理的实例。在这个例子中有两个WebService 类：LoginService 和SearchService ，代码如下：

LoginService.java

package ?service;
import ?org.apache.axis2.context.MessageContext;
import ?org.apache.axis2.context.ServiceGroupContext;
public ? class ?LoginService
{
???? public ? boolean ?login(String?username,?String?password)
????{????????
???????? if ( " bill " .equals(username)? && ? " 1234 " .equals(password))
????????{
???????????? // ??第1步：设置key-value对
????????????MessageContext?mc? = ?MessageContext.getCurrentMessageContext();
????????????ServiceGroupContext?sgc? = ?mc.getServiceGroupContext();
????????????sgc.setProperty( " login " ,? " 成功登录 " );????
???????????? return ? true ;
????????}
???????? else
????????{
???????????? return ? false ;
????????}
????}????
???? public ?String?getLoginMsg()
????{
??????? // ??第1步：获得key-value对中的value
????????MessageContext?mc? = ?MessageContext.getCurrentMessageContext();
????????ServiceGroupContext?sgc? = ??mc.getServiceGroupContext();
???????? return ?(String)sgc.getProperty( " login " );????
????}
}

SearchService.java

package ?service;
import ?org.apache.axis2.context.MessageContext;
import ?org.apache.axis2.context.ServiceGroupContext;
public ? class ?SearchService
{
???? public ?String?findByName(String?name)
????{
???????? // ??第1步：获得key-value对中的value
????????MessageContext?mc? = ?MessageContext.getCurrentMessageContext();
????????ServiceGroupContext?sgc? = ??mc.getServiceGroupContext();????????????????
???????? if ?(sgc.getProperty( " login " )? != ? null )
???????????? return ? " 找到的数据< " ? + ?name? + ? " > " ;
???????? else
???????????? return ? " 用户未登录 " ;
????}
}

services.xml 文件中的配置代码如下：

< serviceGroup >
???? <!-- ??第2步：添加scope属性，并设置属性值为application? -->
???? < service? name ="loginService" ?scope ="application" >
???????? < 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 >
???? <!-- ??第2步：添加scope属性，并设置属性值为application? -->
???? < service? name ="searchService" ?scope ="application" >
???????? < description >
????????????搜索服务
???????? </ description >
???????? < parameter? name ="ServiceClass" >
????????????service.SearchService
???????? </ parameter >
???????? < messageReceivers >
???????????? < messageReceiver? mep ="http://www.w3.org/2004/08/wsdl/in-out"
????????????????class ="org.apache.axis2.rpc.receivers.RPCMessageReceiver" ? />
???????? </ messageReceivers >
???? </ service >
</ serviceGroup >

第3 步与 《WebService大讲堂之Axis2(5)：会话（Session）管理》一文中 介绍的方法类似。

下面是使用两个stub 类的对象实例访问上面实现的两个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);
????SearchServiceStub?searchStub? = ? new ?SearchServiceStub();
????SearchServiceStub.FindByName?fbn? = ? new ?SearchServiceStub.FindByName();
????fbn.setName( " abc " );
????System.out.println(searchStub.findByName(fbn).local_return);?
}

在执行上面的代码后，将输出如下的信息：

成功登录

找到的数据 < abc >

读者可以将scope属性值改成transportsession，看看会输出什么！

??? 实际上，Axis2的会话管理也是通过Cookie实现的，与Web应用中的Session管理类似。如果读者使用C#访问支持会话（在同一个服务中的会话管理）的WebService，需要指定一个CookieContainer对象，代码如下：

service.loginService?ls? = ? new ?service.loginService();
System.Net.CookieContainer?cc? = ? new ?System.Net.CookieContainer();
ls.CookieContainer? = ?cc;
bool ?r,?rs;
ls.login( " bill " ,? " 1234 " ,? out ?@r,? out ?rs);
if ?(r)
{
????MessageBox.Show(ls.getLoginMsg().@return);
}

如果是访问跨服务的支持会话的WebService ，则不需要指定CookieContainer 对象，代码如下：

service.loginService?ls? = ? new ?service.loginService();
bool ?r,? out ?rs);
if ?(r)
{
????service1.searchService?ss? = ? new ?service1.searchService();
????MessageBox.Show(ss.findByName( " abc " ));
}

如果读者使用delphi （本文使用的是delphi2009 ，其他的delphi 版本请读者自行测试）调用支持会话的WebService 时有一些差别。经笔者测试，使用delphi 调用WebService ，将scope 属性值设为transportsession 和application 都可以实现跨服务的会话管理，这一点和Java 与C# 不同，Java 和C# 必须将scope 属性值设为application 才支持跨服务会话管理。在delphi 中不需要象C# 指定一个CookieContainer 或其他类似的对象，而只需要象访问普通的WebService 一样访问支持会话的WebService 即可。