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

接mina的IoConnector

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

2

3

4

ConnectFuture future = connector.connect(newInetSocketAddress(

                    HOST, PORT));// 创建连接

            future.awaitUninterruptibly();// 等待连接创建完成

            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.

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

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

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

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

蓝色：驱动读写操作。

绿色：管理连接。

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

橘色：统计数据。

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

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

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

privatefinal IoHandler handler;

 

    protectedIoSessionConfig config;

 

      privatefinal IoService service;

 

    privatestatic final AttributeKey READY_READ_FUTURES_KEY = newAttributeKey(AbstractIoSession.class,

            "readyReadFutures");

privatestatic final IoFutureListener<CloseFuture> SCHEDULED_COUNTER_RESETTER;

 

  privatestatic final WriteRequest CLOSE_REQUEST = newDefaultWriteRequest(newObject());

 

    privateIoSessionAttributeMap attributes;

 

    privateWriteRequestQueue writeRequestQueue;

 

privateWriteRequest currentWriteRequest;

 

privatefinal CloseFuture closeFuture = newDefaultCloseFuture(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的一些默认传输配置，当然这些数字都不是随便写的，为什么最小要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

2

3

publicAttributeKey(Class<?> source, String name) {

        this.name = source.getName() + '.'+ name + '@'+ Integer.toHexString(this.hashCode());

    }

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

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

publicfinal ReadFuture read() {

        if(!getConfig().isUseReadOperation()) {

            thrownew IllegalStateException("useReadOperation is not enabled.");

        }

 

        Queue<ReadFuture> readyReadFutures = getReadyReadFutures();

        ReadFuture future;

        synchronized(readyReadFutures) {

            future = readyReadFutures.poll();

            if(future != null) {

                if(future.isClosed()) {

                    // Let other readers get notified.

                    readyReadFutures.offer(future);

                }

            }else{

                future = newDefaultReadFuture(this);

                getWaitingReadFutures().offer(future);

            }

        }

 

        returnfuture;

    }

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

下面是写操作：

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

publicWriteFuture write(Object message, SocketAddress remoteAddress) {

        if(message == null) {

            thrownew IllegalArgumentException("Trying to write a null message : not allowed");

        }

 

        // We can't send a message to a connected session if we don't have

        // the remote address

        if(!getTransportMetadata().isConnectionless() && (remoteAddress != null)) {

            thrownew UnsupportedOperationException();

        }

 

        // If the session has been closed or is closing, we can't either

        // send a message to the remote side. We generate a future

        // containing an exception.

        if(isClosing() || !isConnected()) {

            WriteFuture future = newDefaultWriteFuture(this);

            WriteRequest request = newDefaultWriteRequest(message, future, remoteAddress);

            WriteException writeException = newWriteToClosedSessionException(request);

            future.setException(writeException);

            returnfuture;

        }

 

        FileChannel openedFileChannel = null;

 

        // TODO: remove this code as soon as we use InputStream

        // instead of Object for the message.

        try{

            if((message instanceofIoBuffer) && !((IoBuffer) message).hasRemaining()) {

                // Nothing to write : probably an error in the user code

                thrownew IllegalArgumentException("message is empty. Forgot to call flip()?");

            }elseif (message instanceofFileChannel) {

                FileChannel fileChannel = (FileChannel) message;

                message = newDefaultFileRegion(fileChannel, 0, fileChannel.size());

            }elseif (message instanceofFile) {

                File file = (File) message;

                openedFileChannel = newFileInputStream(file).getChannel();

                message = newFilenameFileRegion(file, openedFileChannel, 0, openedFileChannel.size());

            }

        }catch(IOException e) {

            ExceptionMonitor.getInstance().exceptionCaught(e);

            returnDefaultWriteFuture.newNotWrittenFuture(this, e);

        }

 

        // Now, we can write the message. First, create a future

        WriteFuture writeFuture = newDefaultWriteFuture(this);

        WriteRequest writeRequest = newDefaultWriteRequest(message, writeFuture, remoteAddress);

 

        // Then, get the chain and inject the WriteRequest into it

        IoFilterChain filterChain = getFilterChain();

        filterChain.fireFilterWrite(writeRequest);

 

        // TODO : This is not our business ! The caller has created a

        // FileChannel,

        // he has to close it !

        if(openedFileChannel != null) {

            // If we opened a FileChannel, it needs to be closed when the write

            // has completed

            finalFileChannel finalChannel = openedFileChannel;

            writeFuture.addListener(newIoFutureListener<WriteFuture>() {

                publicvoid operationComplete(WriteFuture future) {

                    try{

                        finalChannel.close();

                    }catch(IOException e) {

                        ExceptionMonitor.getInstance().exceptionCaught(e);

                    }

                }

            });

        }

 

        // Return the WriteFuture.

        returnwriteFuture;

    }

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

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