liaoqingfu / agilnet

一个基于reactor模式的Linux/C++网络库，支持one loop per thread机制。

agilNet

一个基于reactor模式+epoll复用机制的C++网络库，支持one loop per thread. 参考学习陈硕的muduo

并发性能测试：日后更新

零.代码编译

目前是配置codeblocks工程开发编译/调试。
1.apt-get install gcc
2.apt-get install g++
3.apt-get install libboost-all-dev
4.apt-get install codeblocks
5.用codeblocks打开demo目录下工程，点击build即可。

一.目录结构

1.demo 相关测试例程
2.net 网络库的主要实现，包括reactor模式实现与TCP相关类封装
3.support 网络库的依赖，包括log，线程同步机制，及线程/线程池

二.reactor模式实现细节  

1.Epoll类 :对linux epoll的封装，包括对epoll添加/删除/修改事件，以及调用wait操作等待事件
2.IOEvent类:对事件的封装，包括一个文件fd成员变量，以及相关读写事件处理函数。所有需要响应事件的类都在内部包含一个IOEvent成员变量对象，并注册到loop中
3.IOEventCtrl类: 内部包含一个IOEvent事件池，该类把事件注册到Epoll中，并调用waitAndRunHandle()等待并获得事件触发，并调用事件池中的事件回调函数
4.IOEventLoop类: 事件循环类，一个事件循环类对应一个线程，内部包含一个IOEventCtrl成员变量，在run()函数中调用该成员变量等待/执行事件

三.Tcp相关类封装

1.TcpAccept : 内部包括一个成员变量Socket对象，以及IOevent类，当有新连接时触发事件
2.TcpConnec : TCP连接类，代表一次新的连接。当服务器与连接读写数据时触发事件
3.TcpServer : Tcp服务器，内部包括一个 TcpConnect池，有新的连接时候向该池增加Tcpconnect对象，当连接断开时在池中删掉该对象
4.Buffer   : 对缓存的封装
5 Socket 与SocketOperation : socket 与socket操作的封装

四.定时器列队实现原理

1.在TimerQueue类中初始化一个timerFd，并加入epoll事件中等待触发
2.考虑到可能会有多个相同时间的定时器，TimerQueue中有两个multimap容器：oniceTimers和everyTimers，分别是定时只运行一次的事件，和定隔每次运行的事件
3.每次添加定时器容器，如果加入事件比容器中时间最近的事件还近，则重置定时器为新添加事件
4.定时器事件被触发时，执行设置时间小于当前时间的定时器回调函数，并删除列队。如果间隔每次触发的事件，则删除元素后，更新时间重新添加。

五.One loop per thread机制支持

1.support/Thread类 ：把boost.thead封装成类似Qt/QThead,用户线程需继承Thread类，实现纯虚函数run(),并调用start()启动线程。
2.net/IOEventLoopThread类 ：Thread类的子类，实现具体业务逻辑，对应一个IOEventLoop事件循环，并在IOEventLoop记录当前线程ID。
3.net/IOEventLoopThreadPool类 ：线程池类，有新连接建立时，从线程池中分配一个线程给该TCP连接使用。

六.关于该库的使用

只要继承自TcpServer类并实现几个虚事件函数即可.详见dome文件夹