Mina Basics 04- 会话
介绍
会话是MINA的核心：每次客户端连接到服务器时，都会在服务器上创建一个新会话，并将保留在内存中，直到客户端断开连接。如果您在客户端使用MINA，则每次连接到服务器时，也会在客户端上创建会话。
会话是MINA的核心：每次客户端连接到服务器时，都会在服务器上创建一个新会话，并将保留在内存中，直到客户端断开连接。如果您在客户端使用MINA，则每次连接到服务器时，也会在客户端上创建会话。
这也是您在会话中需要执行的任何操作的访问点：发送消息，关闭会话等...
至关重要的是要理解由于NIO的异步本质，从会话中读取并没有多大意义。实际上，当一些传入消息到达时，您的应用程序会发出信号，这是IoHandler负责处理此类事件。换句话说，不要调用session.read（）。决不。
会话状态
会话具有状态，该状态将在时间内发展。
1.已连接：会话已创建且可用
2.空闲：会话至少在一段时间内没有处理任何请求（此时间段是可配置的）
(1)空闲读：实际上没有读过一段时间
(2)闲置写：实际上没有写过一段时间
(3)两者都空闲：一段时间内没有读或写
3. 关闭中：会话正在关闭（剩余的消息正在刷新，清理不会终止）
4. 已关闭：会话现已关闭，无法通过其他方式恢复会话。这实际上不是一个真实的状态：当会话关闭时，它被删除。
以下状态图公开了所有可能的状态和转换：
我们有一组方法来获取有关会话状态的一些信息。
会话状态：
1.isActive（）：告诉会话是否有效（根据实现可能意味着不同的事情）
2.isClosing（）：告诉会话是否已被关闭
3.isConnected（）：告诉会话是否处于活动状态（即，不处于关闭模式）
打开一个会话
实际上，你无需做任何事情：它是自动的！每当远程对等方连接到服务器时，服务器将创建新连接。在客户端，每次连接到服务器时，都会创建一个会话。
此会话作为参数传递给您的处理程序，以便您可以在应用程序中对其执行某些操作。在客户端，当您连接到服务器时，您可以通过以下方式返回创建的会话：
ConnectFuture connectionFuture = connector.connect(address);
connectionFuture.awaitUninterruptibly();
if (!connectionFuture.isConnected()) { return false; } session = connectionFuture.getSession();
您也可以以最短的方式完成：
session = connector.connect(address).getSession();
初始化
创建新会话时，必须对其进行初始化。这是使用默认的IoService配置完成的，您可以稍后更新此配置。实际上，在创建会话时，我们会在内部创建存储在会话中的默认IoService配置的副本，这是将使用的配置实例（可以修改）。
此初始化还将启动统计计数器，创建属性容器，将写入队列关联到会话（这是消息将被发送到其中的位置），最终，您是否提供了要执行的特定任务在这个阶段，它会调用它。
关闭会话
会话可以以4种方式关闭，其中两种是显式的：当远程对等方在发生异常时很好地关闭连接时，调用closeNow（）方法（显式）调用closeOnFlush（）方法（显式）
（注意，不应再使用两种不推荐使用的方法：close（boolean）和close（））
显式关闭
前两个方法可以在应用程序的任何地方调用，最大的区别是一个（closeNow（））将简单地关闭会话，丢弃任何等待传输给对等方的消息，而closeOnFlush（）将等待任何待处理的消息已传输给同伴。
请注意，如果远程对等体不再连接，则使用_closeOnFlush（）_调用关闭的会话将永远不会被销毁，除非您还处理其空闲状态，或者在系统TCP超时关闭套接字之前 - 可能需要几个小时 - 。始终管理应用程序中的空闲状态。
远程对等关闭
当远程对等方正确关闭会话时，将关闭会话，并且将丢弃所有待处理的消息。这通常是它的工作方式。
但是，有时候，远程对等方没有正确关闭连接（这可能发生在电缆被粗暴地拔掉时）。在这种情况下，会话永远不会被告知断开连接。了解它的唯一方法是定期检查会话状态：如果它的空闲时间超过特定时间 - 必须配置 - ，然后应用程序可以决定关闭会话。否则，当达到TCP超时时，会话将最终关闭（可能需要数小时......）。
异常
在某些情况下，会发生导致会话关闭的例外情况。通常，在创建会话时，我们可能会遇到问题，会话将立即关闭。另一种可能性是我们不能写一些消息，例如因为频道已经关闭：我们然后关闭会话。
总而言之，每当我们在处理会话时遇到异常时，此会话将被关闭。
当然，您的应用程序将通过ExeptionCaught事件通知。
配置
可以为特定会话设置许多不同的参数：
1.接收缓冲区大小
2.发送缓冲区大小
3.空闲时间
4.写数据的超时时间
5. ……
加上其他配置，具体取决于使用的传输类型（参见第6章 – 传输）。
所有这些配置参数都存储在IoSessionConfig对象中，该对象可以使用session.getConfig（）方法从会话中获取。
有关会话配置的更多信息，请参阅第4.1章 - 会话配置
管理用户定义的属性
可能需要存储一些可能在以后使用的数据。这是使用与每个会话相关联的专用数据结构来完成的。这是一个键值关联，可以存储开发人员可能希望在会话期间保持剩余的任何类型的数据。
例如，如果要跟踪用户自创建会话以来发送的请求数，则可以轻松将其存储到此映射中：只需创建与此值关联的密钥即可。
int counterValue = session.getAttribute( "counter" ); session.setAttribute( "counter", counterValue + 1 ); ...
我们有办法将存储的属性处理到会话中：属性是键/值对，可以从会话的容器中添加，删除和读取。
创建会话时会自动创建此容器，并在会话终止时将其销毁。
会话容器
正如我们所说，这个容器是一个键/值容器，默认为Map，但如果想要处理长寿命数据，或者如果它们很大则避免将所有这些数据存储在内存中，也可以定义另一个数据结构。 ：我们可以实现一个接口和一个工厂，用于在创建会话时创建此容器。
这段代码显示了在会话初始化期间如何创建容器：
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;
}
会话属性访问
有许多方法可用于操作会话的属性：
boolean containsAttribute（Object key）：告诉是否存在给定的属性
Object getAttribute（Object key）：获取给定属性的值
Object getAttribute（Object key，Object defaultValue）：获取给定属性的值，如果不存在则获取默认值
Set <Object> getAttributeKeys（）：获取所有存储属性的集合
Object removeAttribute（Object key）：删除给定的属性
boolean removeAttribute（Object key，Object value）：删除给定的属性/值对
boolean replaceAttribute（Object key，Object oldValue，Object newValue）：替换给定属性/值对
Object setAttribute（Object key）：添加没有值的新属性
Object setAttribute（Object key，Object value）：添加新的属性/值对
Object setAttributeIfAbsent（Object key）：添加一个没有值的新属性（如果它尚不存在）
Object setAttributeIfAbsent（Object key，Object value）：添加一个新的属性/值对，如果它尚不存在
所有这些方法都允许您的应用程序存储，删除，获取或更新存储在会话中的属性。另请注意，MINA内部使用了一些属性：不要轻易修改那些你没有创建的属性！
过滤链
每个会话都与一系列过滤器相关联，这些过滤器将在接收或发出传入请求或传出消息时进行处理。这些过滤器是针对每个会话单独指定的，即使大多数情况下，我们将对所有现有会话使用完全相同的过滤器链。
但是，可以动态修改单个会话的链，例如通过在链中为特定会话添加记录器筛选器。
统计
每个会话还会记录会话的内容：
1.接收/发送的字节数
2.收到/发送的消息数量
3.空闲状态
4.吞吐量
和许多其他有用的信息。
有关会话统计信息的更多信息，请参阅第4.2章 - 会话统计信息
处理器Handler
最后，并非最不重要的是，会话附加到Handler，负责将消息分发给您的应用程序。此处理程序还将通过使用会话发送回响应，只需调用write（）方法：
session.write( <your message> );
第4.1章 - 会话配置
介绍
根据会话的类型，我们可以配置各种元素。其中一些元素在所有会话类型中共享，其他一些是特定的。
我们目前支持4种会话风格：
1.套接字：支持TCP传输
2.数据报：支持UDP传输
3.Serial：支持RS232传输
4.VmPipe：支持IPC传输
一般参数
以下是所有全局参数的列表（可以为任何会话风格设置它们）：
|
参数 |
类型 |
描述 |
默认值 |
|
idleTimeForBoth |
int |
通知在读取和写入时空闲的会话之前等待的秒数 |
无穷 |
|
idleTimeForRead |
int |
通知读取空闲的会话之前等待的秒数 |
无穷 |
|
idleTimeForWrite |
int |
通知写入时空闲的会话之前等待的秒数 |
无穷 |
|
maxReadBufferSize |
int |
用于读取数据的缓冲区的最大大小 |
65536 bytes |
|
minReadBufferSize |
int |
用于读取数据的缓冲区的最小大小 |
64 bytes |
|
readBufferSize |
int |
用于读取incomming数据的缓冲区的默认大小 |
2048 bytes |
|
throughputCalculationInterval |
int |
每个吞吐量计算之间的间隔（秒）。 |
3s |
|
useReadOperation |
boolean |
当我们允许应用程序执行__session.read（）_时，标志设置为TRUE |
FALSE |
|
writeTimeout |
int |
在挽救写入操作之前延迟等待完成 |
60s |
可以通过使用getter和setter来访问所有这些参数（useReadOperation参数getter使用isUseReadOperation（）方法）。
套接字特定参数
|
参数 |
类型 |
描述 |
默认值 |
|
defaultReuseAddress |
boolean |
SO_REUSEADDR标志的值 |
true |
|
keepAlive |
boolean |
SO_KEEPALIVE标志的值 |
false |
|
oobInline |
boolean |
SO_OOBINLINE标志的值 |
false |
|
receiveBufferSize |
int |
SO_RCVBUF参数的值 |
-1 |
|
reuseAddress |
boolean |
SO_REUSEADDR标志的值 |
false |
|
sendBufferSize |
int |
SO_SNDBUF参数的值 |
-1 |
|
soLinger |
int |
SO_LINGER参数的值 |
-1 |
|
tcpNoDelay |
boolean |
TCP_NODELAY标志的值 |
false |
|
trafficClass |
int |
IP_TOS参数的值。 IPTOS_LOWCOST（0x02），IPTOS_RELIABILITY（0x04），IPTOS_THROUGHPUT（0x08）或IPTOS_LOWDELAY（0x10）之一 |
0 |
数据报特定参数
|
参数 |
类型 |
描述 |
默认值 |
|
|
broadcast |
boolean |
SO_BROADCAST标志的值 |
false |
|
|
closeOnPortUnreachable |
boolean |
告诉我们是否应该在端口无法访问时关闭会话 |
true |
|
|
receiveBufferSize |
int |
SO_RCVBUF参数的值 |
-1 |
|
|
reuseAddress |
boolean |
SO_REUSEADDR标志的值 |
false |
|
|
sendBufferSize |
int |
SO_SNDBUF参数的值 |
-1 |
|
|
trafficClass |
int |
IP_TOS参数的值。 IPTOS_LOWCOST（0x02），IPTOS_RELIABILITY（0x04），IPTOS_THROUGHPUT（0x08）或IPTOS_LOWDELAY（0x10）之一 |
0 |
|
串行特定参数
|
参数 |
类型 |
描述 |
默认值 |
|
inputBufferSize |
int |
要使用的输入缓冲区大小 |
8 |
|
lowLatency |
boolean |
设置低延迟模式 |
false |
|
outputBufferSize |
int |
要使用的输出缓冲区大小 |
8 |
|
receiveThreshold |
int |
以字节为单位设置接收阈值（将其设置为-1表示禁用） |
-1 |
第4.2章 - 会话统计
我们会在每个会话中保留一些有关正在发生的事情的统计数据。并非所有这些统计数据都是通过每条消息计算出来的：其中一些是按需计算的。
|
参数 |
类型 |
描述 |
默认值 |
|
readBytes |
long |
自会话创建以来读取的总字节数 |
yes |
|
readBytesThroughput |
double |
最后一个时间间隔内每秒读取的字节数 |
no |
|
readMessages |
long |
自会话创建以来读取的消息总数 |
yes |
|
readMessagesThroughput |
double |
上一个时间间隔内每秒读取的消息数 |
no |
|
scheduledWriteBytes |
AtomicInteger |
等待写入的字节数 |
yes |
|
scheduledWriteMessages |
AtomicInteger |
等待写入的消息数 |
yes |
|
writtenBytes |
long |
自会话创建以来写入的总字节数 |
yes |
|
writtenBytesThroughput |
double |
最后一个时间间隔内每秒写入的字节数 |
no |
|
writtenMessages |
long |
自会话创建以来写入的消息总数 |
yes |
|
writtenMessagesThroughput |
double |
在最后一个时间间隔内每秒写入的消息数 |
no |
可以使用getter读取所有这些参数。
