Apache Mina 文档翻译

84366992

第四章 - 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> );
...