Mina源码阅读笔记（五）—Mina对连接的操作IoSession

2022-12-24 08:24:33

IoSession是Mina管理两端的一个重要部分，也是Mina的核心，Session具有了生命周期的概念，它的生命周期和连接时紧密相关的，这点在后面的介绍中会涉及。另外，好像hibernate中也有session也有生命周期（真的是好久没有用了，连hibernate有里session是干嘛的都想不起来了）。

在读源码之前，我们还是先了解下IoSession的作用和一些基本概念。IoSession的主要作用有如下一些：

l  管理连接。注意，这里的管理连接并不是直接去控制我们上次讲的最底层的连接acceptor和connector。如果acceptor和connector建立的一条管道，那session就是在管道内的管理者，他是没有办法将管道对半拆分开的，他只能从内部阻断两边的通信。管理连接还有部分就是可以配置缓冲区的大小，闲置时间等等。

l  存储信息。和web里的session一样，这里的session也有存储attribute的功能，不过一般来说，这里存储的都是和连接有关的东西，并不会像web开发一样存一些业务上的东西。

l  驱动读写操作。我不知道用驱动这个词是否合适，那个例子来说，session.write。

l  统计功能。Session还记录了连接中的byte、message等数量。

Session在使用中是通过ConnectionFuture获得的：

1 ConnectFuture
future = connector.connect(new InetSocketAddress(
2                     HOST,
PORT));//
创建连接
3             future.awaitUninterruptibly();//
等待连接创建完成
4             session
= future.getSession();//
获得session

说完作用，就是session的状态了，我们读源码的时候，也会跟着session的状态来读：

  • Connected : the session has been created and is available
  • Idle : the session hasn't processed any request for at least a period of time (this period is configurable)
    • Idle for read : no read has actually been made for a period of time
    • Idle for write : no write has actually been made for a period of time
    • Idle for both : no read nor write for a period of time
  • Closing : the session is being closed (the remaining messages are being flushed, cleaning up is not terminated)
  • Closed : The session is now closed, nothing else can be done to revive it.

Mina源码阅读笔记（五）—Mina对连接的操作IoSession

注意，这里的最开始的connect，最后的closed这些都说的是acceptor和connector之间的操作，是他们的状态来影响session的状态。和hibernate不一样，那个的操作也是session自己的（session.close等），这里的session是没办法控制通道的。

了解完了基础的，我们来看看代码层面的实现，在org,apache.mina.core.session包中主要实现了IoSession的相关功能。我们从IoSession这个接口开始看起：

Mina源码阅读笔记（五）—Mina对连接的操作IoSession

内容比较多，比之前的那几篇都难多了。我们还是按照上图画出来的方框对这些方法进行分分类，看看是不是跟我们之前分析的一样：

红色：得到一系列配置等。我们说了session是mina的核心。

蓝色：驱动读写操作。

绿色：管理连接。

黑色：存储功能，是不是和JSP里的session很像。

橘色：统计数据。

有些没有框上的并不是说不属于这里面，而是有些我确实不了解，有些是比较难划分，具体的含义可以看源码中，都有说明。

了解完IoSession的最基本功能之后，我们要看看它的具体实现类AbstractIoSession。看具体实现之前，我们先看看这个类关联了哪些比较重要的引用：

01 private final IoHandler
handler;
02  
03     protected IoSessionConfig
config;
04  
05       private final IoService
service;
06  
07     private static final AttributeKey
READY_READ_FUTURES_KEY = new AttributeKey(AbstractIoSession.class,
08             "readyReadFutures");
09 private static final IoFutureListener<CloseFuture>
SCHEDULED_COUNTER_RESETTER;
10  
11   private static final WriteRequest
CLOSE_REQUEST = new DefaultWriteRequest(new Object());
12  
13     private IoSessionAttributeMap
attributes;
14  
15     private WriteRequestQueue
writeRequestQueue;
16  
17 private WriteRequest
currentWriteRequest;
18  
19 private final CloseFuture
closeFuture = new DefaultCloseFuture(this);

在上面的代码中，我们有熟悉的handler，这里我们也可以稍微明确一下handler和session之间的关系了，每次我们在创建服务端和客户端的时候，都必须设置一个handler，如果不设置则报异常，handler里主要处理seesion各种状态时的业务。Service用来管理session。CloseFutrue用来设置通道的关闭，在上面我们已经说过，session的关闭是通过closefuture来操作的。

这些成员变量中，除了我们见过的handler和future，凡是带有write的都来自org.apache.mina.core.write包，这个包作为一个内部的工具类，在session的写操作中起到辅助作用。其他类均来自org.apache.mina.core.session中，这些类组成都比较简单，但都是要了解AbstractIoSession之前，我们要对这里提到的这些对象有所了解。

首先是ioSessionConfig，和它的具体实现AbstractIoSessionCnfig:

Mina源码阅读笔记（五）—Mina对连接的操作IoSession

从上面的图我们很容易就能看到mina的一些默认传输配置，当然这些数字都不是随便写的，为什么最小要64，最大是65535，我相信计算机网络相关课程里应该都会有涉及。

接下来是IoSessionAttributeMap接口，这个接口主要作用就是规定了get、set、remove Attribute的方法。注意存储在session中的变量是一种map关系的变量（key-value），所以我们也很容易明白这个接口命名时为什么后面要多个map出来。至于这个类的实现，它隐藏的很好，放在了一个内部类中。具体可以看IoSessionDataStructureFactory这个接口，这个接口主要是为了这个map形势提供数据结构和规定基本操作。至于这个session中map的底层实现则用了ConcurrentHashMap来做容器，这部分具体可以看内部类DefaultIoSessionAttributeMap。

还有一个就是AttributeKey，这个类主要重写equals方法和hashCode方法，为了将session中的key和对应的session联系起来。因为一个项目中可能有多个session，而不同session中的key可能会相同，所以在构造key和hash的时候会将session也考虑进去。

1 public AttributeKey(Class<?>
source, String name) {
2         this.name
= source.getName() + '.' +
name + '@' +
Integer.toHexString(this.hashCode());
3     }

现在我们可以看AbstractIoSession了。主要看读写操作，其他操作都是统计和配置稍稍看过即可：

01 public final ReadFuture
read() {
02         if (!getConfig().isUseReadOperation())
{
03             throw new IllegalStateException("useReadOperation
is not enabled.");
04         }
05  
06         Queue<ReadFuture>
readyReadFutures = getReadyReadFutures();
07         ReadFuture
future;
08         synchronized (readyReadFutures)
{
09             future
= readyReadFutures.poll();
10             if (future
!= null)
{
11                 if (future.isClosed())
{
12                     //
Let other readers get notified.
13                     readyReadFutures.offer(future);
14                 }
15             } else {
16                 future
= new DefaultReadFuture(this);
17                 getWaitingReadFutures().offer(future);
18             }
19         }
20  
21         return future;
22     }

采用队列进行读取，这里只用了Queue，没有用concurrent中的那些同步队列，而是用了synchronized关键字来处理同步，主要是我们要明白这里要同步的不是队列里的内容，而是读的这个过程，session都是独立的，所以一个session内一个队列无论怎么抢还是能排除顺序的。所以对于读操作来说，主要是要保证在读一条的时候，不能有其他线程再读。

下面是写操作：

01 public WriteFuture
write(Object message, SocketAddress remoteAddress) {
02         if (message
== null)
{
03             throw new IllegalArgumentException("Trying
to write a null message : not allowed");
04         }
05  
06         //
We can't send a message to a connected session if we don't have
07         //
the remote address
08         if (!getTransportMetadata().isConnectionless()
&& (remoteAddress != null))
{
09             throw new UnsupportedOperationException();
10         }
11  
12         //
If the session has been closed or is closing, we can't either
13         //
send a message to the remote side. We generate a future
14         //
containing an exception.
15         if (isClosing()
|| !isConnected()) {
16             WriteFuture
future = new DefaultWriteFuture(this);
17             WriteRequest
request = new DefaultWriteRequest(message,
future, remoteAddress);
18             WriteException
writeException = new WriteToClosedSessionException(request);
19             future.setException(writeException);
20             return future;
21         }
22  
23         FileChannel
openedFileChannel = null;
24  
25         //
TODO: remove this code as soon as we use InputStream
26         //
instead of Object for the message.
27         try {
28             if ((message instanceof IoBuffer)
&& !((IoBuffer) message).hasRemaining()) {
29                 //
Nothing to write : probably an error in the user code
30                 throw new IllegalArgumentException("message
is empty. Forgot to call flip()?");
31             } else if (message instanceof FileChannel)
{
32                 FileChannel
fileChannel = (FileChannel) message;
33                 message
= new DefaultFileRegion(fileChannel, 0,
fileChannel.size());
34             } else if (message instanceof File)
{
35                 File
file = (File) message;
36                 openedFileChannel
= new FileInputStream(file).getChannel();
37                 message
= new FilenameFileRegion(file,
openedFileChannel, 0,
openedFileChannel.size());
38             }
39         } catch (IOException
e) {
40             ExceptionMonitor.getInstance().exceptionCaught(e);
41             return DefaultWriteFuture.newNotWrittenFuture(this,
e);
42         }
43  
44         //
Now, we can write the message. First, create a future
45         WriteFuture
writeFuture = new DefaultWriteFuture(this);
46         WriteRequest
writeRequest = new DefaultWriteRequest(message,
writeFuture, remoteAddress);
47  
48         //
Then, get the chain and inject the WriteRequest into it
49         IoFilterChain
filterChain = getFilterChain();
50         filterChain.fireFilterWrite(writeRequest);
51  
52         //
TODO : This is not our business ! The caller has created a
53         //
FileChannel,
54         //
he has to close it !
55         if (openedFileChannel
!= null)
{
56             //
If we opened a FileChannel, it needs to be closed when the write
57             //
has completed
58             final FileChannel
finalChannel = openedFileChannel;
59             writeFuture.addListener(new IoFutureListener<WriteFuture>()
{
60                 public void operationComplete(WriteFuture
future) {
61                     try {
62                         finalChannel.close();
63                     } catch (IOException
e) {
64                         ExceptionMonitor.getInstance().exceptionCaught(e);
65                     }
66                 }
67             });
68         }
69  
70         //
Return the WriteFuture.
71         return writeFuture;
72     }

这里面有个instanceof FileChannel和File是不是感到有点儿奇怪，mina不是写出去的是IoBuffer么，怎么现在又可以写文件了。Mina作为一个封装好的框架，自然可以直接做文件的传输，这里面会有相应的handler来处理这些业务。

Session部分最主要的就是了解他的生命周期以及相关联的那些引用，这里我们可以看到与读写最密切的就是Future了，所以这部分，就是我下篇会写的主题。

上一篇：Vue2.0源码阅读笔记（一）：选项合并


下一篇：[ActionScript 3.0] 图片左右循环移动