libevent源码分析：hello-world例子

hello-world是libevent自带的一个例子，这个例子的作用是启动后监听一个端口，对于所有通过这个端口连接上服务器的程序发送一段字符：hello-world，然后关闭连接。

 /*
 * gcc -g -o hello-world hello-world.c -levent_core
 */
 #include <sys/socket.h>
 #include <netinet/in.h>
 #include <arpa/inet.h>
 #include <string.h>
 #include <errno.h>
 #include <stdio.h>
 #include <signal.h>
 
 #include <event2/bufferevent.h>
 #include <event2/buffer.h>
 #include <event2/listener.h>
 #include <event2/util.h>
 #include <event2/event.h>
 
 static const char MESSAGE[] = "Hello, World!\n";
 
 static const int PORT = ;
 
 static void listener_cb(struct evconnlistener *, evutil_socket_t, struct sockaddr *, int socklen, void *);
 static void conn_writecb(struct bufferevent *, void *);
 static void conn_eventcb(struct bufferevent *, short, void *);
 static void signal_cb(evutil_socket_t, short, void *);
 
 int main(void)
 {
     struct event_base *base;
     struct evconnlistener *listener;
     struct event *signal_event;
 
     struct sockaddr_in sin;
 
     base = event_base_new();
     if (!base)
     {
         fprintf(stderr, "Could not initialize libevent\n");
         return ;
     }
 
     memset(&sin, , sizeof(sin));
     sin.sin_family = AF_INET;
     sin.sin_port = htons(PORT);
 
     listener = evconnlistener_new_bind(base, listener_cb, (void *)base,
             LEV_OPT_REUSEABLE | LEV_OPT_CLOSE_ON_FREE, -, (struct sockaddr *)&sin, sizeof(sin));
 
     if (!listener)
     {
         fprintf(stderr, "Could not create a listener!\n");
         return ;
     }
     printf("Listening on %d\n", PORT);
 
     signal_event = evsignal_new(base, SIGINT, signal_cb, (void *)base);
 
     if (!signal_event || event_add(signal_event, NULL) < )
     {
         fprintf(stderr, "Could not create/add a signal event!\n");
         return ;
     }
 
     event_base_dispatch(base);
 
     evconnlistener_free(listener);
     event_free(signal_event);
     event_base_free(base);
 
     printf("Done!\n");
     return ;
 }
 
 static void listener_cb(struct evconnlistener *listener, evutil_socket_t fd, struct sockaddr *sa, int socklen, void *user_data)
 {
     struct event_base *base = user_data;
     struct bufferevent *bev;
     struct sockaddr_in *sa_in = (struct sockaddr_in*)sa;
 
     bev = bufferevent_socket_new(base, fd, BEV_OPT_CLOSE_ON_FREE);
     if (!bev)
     {
         fprintf(stderr, "Error construction bufferevent!");
         event_base_loopbreak(base);
         return;
     }
     printf("Recv a new connection, ip[%s], port[%d]\n", inet_ntoa(sa_in->sin_addr), ntohs(sa_in->sin_port));
     bufferevent_setcb(bev, NULL, conn_writecb, conn_eventcb, NULL);
     bufferevent_enable(bev, EV_WRITE);
     bufferevent_disable(bev, EV_READ);
 
     bufferevent_write(bev, MESSAGE, strlen(MESSAGE));
 }
 
 static void conn_writecb(struct bufferevent *bev, void *user_data)
 {
     struct evbuffer *output = bufferevent_get_output(bev);
     if (evbuffer_get_length(output) == )
     {
         printf("flushed answer\n");
         bufferevent_free(bev);
     }
 }
 
 static void conn_eventcb(struct bufferevent *bev, short events, void *user_data)
 {
     if (events & BEV_EVENT_EOF)
     {
         printf("Connection closed.\n");
     }
     else if (events & BEV_EVENT_ERROR)
     {
         printf("Got an error on the connection: %s\n", strerror(errno));
     }
 
     bufferevent_free(bev);
 }
 
 static void signal_cb(evutil_socket_t sig, short events, void *user_data)
 {
     struct event_base *base = user_data;
     struct timeval delay = { ,  };
     printf("Caught an interrupt signal; exiting cleanly in two seconds\n");
     event_base_loopexit(base, &delay);
 }

下面就通过分析这个例子来看一下libevent对于IO事件是如何处理的：

1、调用event_base_new获得event_base对象。

2、调用evconnlistener_new_bind，返回一个struct evconnlistener对象指针，evconnlistener_new_bind函数内部实现如下：

1）调用evutil_socket_函数获取一个socket。

2）调用evconnlistener_new函数获取一个struct evconnlistener对象指针，并返回。

在evconnlistener_new函数内部，首先调用malloc函数分配一个struct evconnlistener_event对象，然后利用传入的形参fd调用listen函数，然后初始化base的各个参数，调用event_assign初始化成员listener。

其实这些函数归根结底还是会调用最基本的libevent函数，只是这些函数对基本的函数做了一些封装提供更高级、更方便的使用方式。

struct evconnlistener和struct evconnlistener_event的定义如下：

 struct evconnlistener {
     const struct evconnlistener_ops *ops;
     void *lock;
     evconnlistener_cb cb;
     evconnlistener_errorcb errorcb;
     void *user_data;
     unsigned flags;
     short refcnt;
     int accept4_flags;
     unsigned enabled : ;
 };
 
 struct evconnlistener_event {
     struct evconnlistener base;
     struct event listener;
 };

关于这里，我有些不明白的是listener是如何被调用event_add函数的？答案在这里

3、调用evsignal_new函数获取一个信号事件对象，其实这个函数也是对event_new函数的封装。

 #define evsignal_new(b, x, cb, arg)                \
     event_new((b), (x), EV_SIGNAL|EV_PERSIST, (cb), (arg))

4、调用event_base_dispatch函数进入事件循环。

5、调用evconnlistener_free释放struct evconnlistener对象。

然后看一下回调函数，在创建evconnlistener对象时传入了一个回调函数：listener_cb，该函数会在监听对象有新连接到来时被调用，在它的内部，首先创建一个struct bufferevent对象，然后设置该对象的回调函数，然后就是调用bufferevent_write函数将要发送的数据写入到该对象对应的buffer中，就不用管了。

由此可见使用libevent库来开发网络服务器是多么的方便，高效。

至此一个基于libevent的简单服务器就完成了，只能对连接上的客户端发送“hello world”然后关闭连接。