libevent 使用流程

使用流程

1. 创建一个事件处理框架
2. 创建一个事件
3. 事件添加到处理框架
4. 开始事件循环
5. 释放资源

事件处理框架 - event_base

1. 使用libevent函数之前需要分配一个或者多个event_base结构体. 每个event_base结构体有一个事件集合,可以检测以确定哪个事件是激活的.
   • 相当于epoll红黑树的树根
   • 底座
   • 抽象层,完成对event_base的封装
   • 每个event_base都有一种用于检测那种事件已经就绪的"方法",或者说后端
2. 具体操作
   • 创建event_base
     • struct event_base* event_base_new(void);
     • 失败返回NULL
   • 释放event_base
     • event_base_free(struct event_base* base);
   • 循环监听base对应的事件, 等待条件满足
     • event_base_dispatch(struct event_base* base);
3. 查看event_base封装的后端（当前系统中支持那些函数）
   • const char **event_get_supported_methods();
   • 返回一个字符串数组中
   • const char * event_base_get_method(const struct event_base *base);
   • 返回当前使用的IO转接
4. event_base和fork
   • 子进程创建成功后，父进程可以继续使用event_base
   • 子进程中需要继续使用event_base需要重新进行初始化
     • int event_reinit(struct event_base * base)

事件 - event

1. 创建新事件

#define  EV_TIMEOUT         0x01    // 废弃
#define  EV_READ            0x02
#define  EV_WRITE           0x04
#define  EV_SIGNAL          0x08
#define  EV_PERSIST         0x10    // 持续触发
#define  EV_ET              0x20    // 边沿模式

typedef void(*event_callback_fn)(evutil_sockt_t,short,void *);

struct event *event_new（
    struct event_base *base,
    evutil_socket_t fd,     // 文件描述符-int
    shord what,
    event_callback_fn cb,   // 事件处理动作
    void *arg
）;

1. 释放事件
   • void event_free(struct event *event);

2. 设置未决事件(有资格但是没有被处理的事件)

   • 构造事件之后,在将其添加到 event_base 之前实际上是不能对其做任何操作的。使用event_add()将事件添加到event_base, 非未决事件 -> 未决事件.
   • 函数
     int event_add( struct event *ev, const struct timeval *tv );
   • tv:
     • NULL: 事件被触发, 对应的回调被调用
     • tv = {0, 100}, 如果设置的时间,
       • 在改时间段内检测的事件没被触发, 时间到达之后, 回调函数还是会被调用
   • 函数调用成功返回0, 失败返回-1
3. 设置非未决(还没有资格被处理的事件)
   • int event_del(struct event *ev);
   • 对已经初始化的事件调用 event_del()将使其成为非未决和非激活的。如果事件不是未决的或者激活的,调用将没有效果。成功时函数返回 0,失败时返回-1。

事件循环

1. 开始循环
   • 一旦有了一个已经注册了某些事件的 event_base, 就需要让 libevent 等待事件并且通知事件的发生。

   #define EVLOOP_ONCE                        0x01
       事件只会被触发一次
       事件没有被触发, 阻塞等
   #define EVLOOP_NONBLOCK                    0x02
       非阻塞 等方式去做事件检测
       不关心事件是否被触发了
   #define EVLOOP_NO_EXIT_ON_EMPTY  0x04
       没有事件的时候, 也不退出轮询检测

   • int event_base_loop(struct event_base *base, int flags);
     • 正常退出返回0, 失败返回-1
   • event_base_dispatch(struct event_base* base)
     • 等同于没有设置标志的 event_base_loop（）
     • 将一直运行,直到没有已经注册的事件了,或者调用 了event_base_loopbreak()或者 event_base_loopexit()为止。
2. 停止循环
   • 返回值：成功0，失败-1

   struct timeval{
       long tv_sec;
       long tv_usec;
   };

   • 如果 event_base 当前正在执行激活事件的回调 ,它将在执行完当前正在处理的事件后立即退出

   int event_base_loopexit(
       struct event_base *base,
       const struct timeval *tv
   );

   • 让event_base 立即退出循环

   int event_base_loopbreak(struct event_base *base);