Apache Mina 文档翻译 - 第四章 - Session

第四章 - Session


会话(Session)是MINA的最重要的部分之一:每当一个客户端连接到服务器,MINA都会创建一个新的会话,并且会一直保存在内存中,直到客户端断开连接。

会话用来存放连接的持久化信息和请求处理过程中需要的任何信息, 这些信息会存在于整个会话生命周期。

会话状态

会话是有状态的,并且状态会发生变化:
    连接:会话创建并且可用。
    空闲:在一段时间内会话没有任何处理(空闲时间可以配置)
        读空闲:一段时间没有读到数据
        写空闲:一段时间没有写入数据
        两者都空闲:一段时间及没有写入也没有读取数据
    正在关闭:正在关闭会话(还有消息没有同步或清理操作还没结束)
    已经关闭:会话被关闭,不能对会话做任何事情

下面的图描述了状态和它们之间的迁移


 

配置

可以为一个会话设定不用的参数:
    接收缓存区大小
    发送缓冲区大小
    空闲时间
    写操作超时时间
根据你使用的传输协议还有其他的可配置项目

管理用户定义属性

有时候我们需要保存一些数据为了在后面使用。MINA为每一个会话附加一个特殊的数据结构。 这是一个基于键值对的数据结构,你可以在里面保存任何需要的数据。

例如,你想要跟踪从会话建立以后用户发送的请求数, 你可以把这些数据放到map里:只需要为这个值创建一个键就可以:

...
int counterValue = session.getAttribute( "counter" );
session.setAttribute( "counter", counterValue + 1 );
...

 
我们可以通过向会话中设置属性来实现数据存储:一个属性就是一个键值对, 我们可以想会话中添加,从会话中删除和取得这些属性。

属性容器在会话建立时被自动建立,并且在会话结束时自动销毁。

定义容器

就像我们之前说的这个容器是一个键值对容器,默认实现是一个Map,但是我们可以根据需要定义其他的数据结构,例如我们可能希望这些数据可以持久化保存,数据太大不适合保存在内存中等。我们需要实现一个IoSessionAttributeMap接口和一个工厂接口来在会话建立是创建自己的容器。

下面的代码片段显示了如何在会话建立时创建容器:

protected final void initSession(IoSession session,
        IoFuture future, IoSessionInitializer sessionInitializer) {
    ...
    try {
        ((AbstractIoSession) session).setAttributeMap(session.getService()
                .getSessionDataStructureFactory().getAttributeMap(session));
    } catch (IoSessionInitializationException e) {
        throw e;
    } catch (Exception e) {
        throw new IoSessionInitializationException(
                "Failed to initialize an attributeMap.", e);
    }
    ...

 
如果我们想定义另外的容器,就需要实现这里的工厂接口:

public interface IoSessionDataStructureFactory {
    /**
     * Returns an {@link IoSessionAttributeMap} which is going to be associated
     * with the specified <tt>session</tt>.  Please note that the returned
     * implementation must be thread-safe.
     */
     IoSessionAttributeMap getAttributeMap(IoSession session) throws Exception;
 }

过滤器链

每一个会话都关联着一个过滤器链,这个过滤器链在请求进来或接收发送消息时都会被调用。每个会话的过滤器链都是独立的,即使很多时候我们在所有会话上需要的过滤器链是一样的。

但是我们动态的为每一个独立的会话修改过滤器链, 例如为某一个会话单独添加日志过滤器等。

统计

每一个会话都有一些自己的统计信息:

    发送和接受的字节数
    发送和接受的消息数
    空闲状态
    吞吐量
还有很多其他的信息。

Handler

最后会话会传递给IoHandler,这样可以分配消息到你的应用中。IoHandler也可以利用会话的write方法来发送响应。

...
session.write( <your message> );
...

猜你喜欢

转载自zjumty.iteye.com/blog/1877234