libevent简介和使用

libevent是一个基于事件触发的网络库，memcached底层也是使用libevent库。

总体来说，libevent有下面一些特点和优势：
* 事件驱动，高性能；
* 轻量级，专注于网络； 
* 跨平台，支持 Windows、Linux、Mac Os等； 
* 支持多种 I/O多路复用技术， epoll、poll、dev/poll、select 和kqueue 等； 

* 支持 I/O，定时器和信号等事件；

libevent有下面几大部分组成：

* 事件管理包括各种IO（socket）、定时器、信号等事件，也是libevent应用最广的模块；

* 缓存管理是指evbuffer功能；

* DNS是libevent提供的一个异步DNS查询功能；

* HTTP是libevent的一个轻量级http实现，包括服务器和客户端

一些资料：
* libevent官网：http://libevent.org/ 
* libevent API：http://www.monkey.org/~provos/libevent/doxygen-2.0.1/index.html
* CSDN上剖析得很赞的文章：http://blog.csdn.net/sparkliang/article/details/4957667

 //=======================================================

摘要

libevent库的event_set函数与event_add函数源代码解析

event_set函数

 void
 event_set(struct event *ev, int fd, short events,           void (*callback)(int, short, void *), void *arg)

 功能说明：
 （1）event_set函数使用指定的句柄、关注的事件、事件发生时的回调函数、
      回调函数的额外参数，初始化设置struct event结构对象。

   ev->ev_callback = callback;
   ev->ev_arg = arg;
   ev->ev_fd = fd;
   ev->ev_events = events;

   
 （2）将此event结构对象，绑定到全局current_base。

ev->ev_base = current_base;

 （3）设置此event结构对象的优先级，默认为current_base中总有限级数的一半

if(current_base) 
    ev->ev_pri = current_base->nactivequeues/2;

 events参数可以是EV_READ | EV_WRITE。

  #define EV_TIMEOUT 0x01
  #define EV_READ  0x02
  #define EV_WRITE 0x04
  #define EV_SIGNAL 0x08
  #define EV_PERSIST 0x10 /* Persistant event */

 event_add函数

 int event_add(struct event *ev, const struct timeval *tv);

 功能：
 （1）事件注册到IO事件模型，并注册到ev_base的eventqueue

  struct event_base *base = ev->ev_base;
  res = evsel->add(evbase, ev);
  event_queue_insert(base, ev, EVLIST_INSERTED);

 （2）如果该事件已经在活动事件队列或者超时队列中，先从中删除。
      事件当前是否处于某个队列的状态保存在ev->ev_flags中，分别为：

   EVLIST_TIMEOUT   0x01  位于超时队列  
   EVLIST_INSERTED  0x02  位于注册事件队列
   EVLIST_ACTIVE    0x08  位于活动事件队列
   EVLIST_INIT      0x80  初始化状态

 （3）计算超时时标，并将ev加入超时队列

   evutil_timeradd(&now, tv, &ev->ev_timeout);
   event_queue_insert(base, ev, EVLIST_TIMEOUT);

struct event结构

 struct event {
    TAILQ_ENTRY (event) ev_next;
    TAILQ_ENTRY (event) ev_active_next;
    TAILQ_ENTRY (event) ev_signal_next;
    unsigned int min_heap_idx; /* for managing timeouts */
    struct event_base *ev_base;
    int ev_fd;
    short ev_events;
    short ev_ncalls;
    short *ev_pncalls; /* Allows deletes in callback */
    struct timeval ev_timeout;
    int ev_pri;  /* smaller numbers are higher priority */
    void (*ev_callback)(int, short, void *arg);
    void *ev_arg;
    int ev_res;  /* result passed to event callback */
    int ev_flags;
 };

// =============================================================================================

 

下面写了2个简单的使用例子，一个是定时器，一个是TCP服务器，都只涉及到libevent的事件管理模块。

一、简单定时器：实现程序每秒输出一个“Game Over!”

event_init() => evtimer_set() => event_add() =>event_dispatch()

    #include <stdio.h>  
    #include <iostream>  
      
    // libevent头文件  
    #include <event.h>  
    using namespace std;  
      
    // 定时事件回调函数  
    void onTime(int sock, short event, void *arg)  
    {  
        cout << "Game Over!" << endl;  
      
        struct timeval tv;  
        tv.tv_sec = 1;  
        tv.tv_usec = 0;  
        // 重新添加定时事件（定时事件触发后默认自动删除）  
        event_add((struct event*)arg, &tv);  
    }  
      
    int main()  
    {  
        // 初始化  
        event_init();  
      
        struct event evTime;  
        // 设置定时事件  
        evtimer_set(&evTime, onTime, &evTime);  
      
        struct timeval tv;  
        tv.tv_sec = 1;  
        tv.tv_usec = 0;  
        // 添加定时事件  
        event_add(&evTime, &tv);  
      
        // 事件循环  
        event_dispatch();  
      
        return 0;  
    }  

编译并执行，编译加 -levent：

    gapp_devnet_1:/data/home/andyawang/code/2013_11/LibeventTest # mv time.cpp timer.cpp  
    gapp_devnet_1:/data/home/andyawang/code/2013_11/LibeventTest # g++ -o timer timer.cpp -levent  
    gapp_devnet_1:/data/home/andyawang/code/2013_11/LibeventTest # ./timer   
    Game Over!  
    Game Over!  
    Game Over!  
    Game Over!  

二、TCP服务器： 实现监听本机8888端口并输出客户端发送过来的信息

event_base_new()=>event_set()=>event_base_set()=>event_add()=>event_base_dispatch()

    #include <stdio.h>  
    #include <string.h>  
    #include <iostream>  
    #include <sys/socket.h>      
    #include <netinet/in.h>      
    #include <arpa/inet.h>      
    #include <netdb.h>  
      
    #include <event.h>  
    using namespace std;  
      
    // 事件base  
    struct event_base* base;  
      
    // 读事件回调函数  
    void onRead(int iCliFd, short iEvent, void *arg)  
    {  
        int iLen;  
        char buf[1500];  
      
        iLen = recv(iCliFd, buf, 1500, 0);  
      
        if (iLen <= 0) {  
            cout << "Client Close" << endl;  
      
            // 连接结束(=0)或连接错误(<0)，将事件删除并释放内存空间  
            struct event *pEvRead = (struct event*)arg;  
            event_del(pEvRead);  
            delete pEvRead;  
      
            close(iCliFd);  
            return;  
        }  
      
        buf[iLen] = 0;  
        cout << "Client Info:" << buf << endl;  
    }  
      
    // 连接请求事件回调函数  
    void onAccept(int iSvrFd, short iEvent, void *arg)  
    {  
        int iCliFd;  
        struct sockaddr_in sCliAddr;  
      
        socklen_t iSinSize = sizeof(sCliAddr);  
        iCliFd = accept(iSvrFd, (struct sockaddr*)&sCliAddr, &iSinSize);  
      
        // 连接注册为新事件 (EV_PERSIST为事件触发后不默认删除)  
        struct event *pEvRead = new event;  
        event_set(pEvRead, iCliFd, EV_READ|EV_PERSIST, onRead, pEvRead);  
        event_base_set(base, pEvRead);  
        event_add(pEvRead, NULL);  
    }  
      
    int main()  
    {  
      
        int iSvrFd;    
        struct sockaddr_in sSvrAddr;  
                    
        memset(&sSvrAddr, 0, sizeof(sSvrAddr));    
        sSvrAddr.sin_family = AF_INET;    
        sSvrAddr.sin_addr.s_addr = inet_addr("127.0.0.1");      
        sSvrAddr.sin_port = htons(8888);     
                                  
        // 创建tcpSocket（iSvrFd），监听本机8888端口    
        iSvrFd = socket(AF_INET, SOCK_STREAM, 0);    
        bind(iSvrFd, (struct sockaddr*)&sSvrAddr, sizeof(sSvrAddr));    
        listen(iSvrFd, 10);  
      
        // 初始化base  
        base = event_base_new();  
          
        struct event evListen;  
        // 设置事件 ，将事件 和 网络fd 和回调函数，并设置当前的 event_base
        event_set(&evListen, iSvrFd, EV_READ|EV_PERSIST, onAccept, NULL);    
        // 设置为base事件 , 将事件的当前event_base 为 指定的参数
        event_base_set(base, &evListen);  
        // 添加事件 ，将event添加到 队列queue中 
        event_add(&evListen, NULL);  
          
        // 事件循环  
        event_base_dispatch(base);  
      
        return 0;  
    }  

来自：http://blog.csdn.net/yyyiran/article/details/12219737