Apache Mina 文档翻译
第四章 - 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> );
...
页:
[1]