libevent 接收TCP连接
Evconnlistener 机制为您提供了侦听和接受传入的 TCP 连接的方法。下面的函数全部包含在`<event2/listener.h>`中。
evconnlistener
创建监听对象
struct evconnlistener *evconnlistener_new(struct event_base *base,evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,evutil_socket_t fd);struct evconnlistener *evconnlistener_new_bind(struct event_base *base,evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,const struct sockaddr *sa, int socklen);void evconnlistener_free(struct evconnlistener *lev);
两个函数都会申请空间并返回一个新的连接对象`evconnlistener`，其中第一个函数需要自己绑定套接字，而第二个函数会自动绑定套接字。`evconnlistener`根据`event_base`来判断TCP连接请求，每当到来一个请求，它就会调用`evconnlistener_cb`回调函数来处理该请求。`ptr`是回调函数的参数，`backlog`指定了`listen`的个数，而`flag`参数如下：
* LEV_OPT_LEAVE_SOCKETS_BLOCKING 设置阻塞* LEV_OPT_CLOSE_ON_FREE 释放掉 `evconnlistener`会关闭socket* LEV_OPT_CLOSE_ON_EXEC * LEV_OPT_REUSEABLE `socket`重用* LEV_OPT_THREADSAFE 为socket增加锁，用于多线程/多进程操作* LEV_OPT_DISABLED* LEV_OPT_DEFERRED_ACCEPT
回调函数如下：
typedef void (*evconnlistener_cb)(struct evconnlistener *listener,evutil_socket_t sock, struct sockaddr *addr, int len, void *ptr)
`evconnlistener`为接收连接的`evconnlistener`对象，`sock`为套接字，`addr`和`len`为请求的地址和其长度，`ptr`是传给`evconnlistener_new`的。
开启和关闭连接监听
int evconnlistener_disable(struct evconnlistener *lev);int evconnlistener_enable(struct evconnlistener *lev);
改变回调函数
void evconnlistener_set_cb(struct evconnlistener *lev, evconnlistener_cb cb, void *arg);
检测当前evconnlistener
evutil_socket_t evconnlistener_get_fd(struct evconnlistener *lev); /* 获取sockfd */struct event_base *evconnlistener_get_base(struct evconnlistener *lev); /* 获取event_base */
检测错误
typedef void (*evconnlistener_errorcb)(struct evconnlistener *lis, void *ptr);void evconnlistener_set_error_cb(struct evconnlistener *lev, evconnlistener_errorcb errorcb);
该函数为错误设置回调函数，每当`listener`发生错误都会触发回调函数的执行。
例子
#include#include #include #include #include #include using namespace std;static void accept_conn_cb(struct evconnlistener *listener, evutil_socket_t fd, struct sockaddr* addr, int len, void *ptr){ /* get libevent event_base from listener */ struct event_base* base = evconnlistener_get_base(listener); cout<<"accept a link"<
//在服务器上监听一个端口来接受新的连接.//传统的方法是调用 socket、bind、listen、accept 等函数.//libevent为我们提供了一个封装 evconnlistener , 只要设置好回调函数即可接受处理新连接.//evconnlistener回调函数的原型.//当接受到一个新连接并且帮我们accept好后,会调用这个函数.//sock是新连接的fd , addr是该连接的地址,ptr是evconnlistener_new()传入的参数.//typedef void (*evconnlistener_cb)(struct evconnlistener *listener,// evutil_socket_t sock, struct sockaddr *addr, int len, void *ptr);//创建evconnlistener.(传入一个fd,这个fd已经绑定到一个端口).//如果cb参数为NULL,则暂时不能接受连接,直到我们设置了回调函数.//flag参数传入一些选项,可以控制evconnlistener的行为.//backlog参数是listen()函数的第二个参数,如果为负数,libevent会选择一个恰当的值.//struct evconnlistener *evconnlistener_new(struct event_base *base,// evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,// evutil_socket_t fd);//创建evconnlistener.(其他同上函数,不同的是这个函数帮我们创建fd并bind)//struct evconnlistener *evconnlistener_new_bind(struct event_base *base,// evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,// const struct sockaddr *sa, int socklen);//销毁evconnlistener.//void evconnlistener_free(struct evconnlistener *lev);//创建evconnlistener时的flag可以是下列选项的组合.//1.LEV_OPT_LEAVE_SOCKETS_BLOCKING : 默认在accept新连接后会设为非阻塞,这个选项取消非阻塞设置.//2.LEV_OPT_CLOSE_ON_FREE : 当销毁evconnlistener的时候关闭监听的socket.//3.LEV_OPT_CLOSE_ON_EXEC : 在监听的socket上设置 FD_CLOEXEC 选项.//4.LEV_OPT_REUSEABLE : 监听端口关闭后端口可立即重用.//5.LEV_OPT_THREADSAFE : 给evconnlistener加锁. (Libevent 2.0.8-rc.)//暂时启用/禁用evconnlistener.//int evconnlistener_disable(struct evconnlistener *lev);//int evconnlistener_enable(struct evconnlistener *lev);//给evconnlistener设置回调函数(如果创建的时候没有设置的话)//void evconnlistener_set_cb(struct evconnlistener *lev,evconnlistener_cb cb, void *arg);//获取监听fd(Libevent 2.0.3-alpha)//evutil_socket_t evconnlistener_get_fd(struct evconnlistener *lev);//获取event_base//struct event_base *evconnlistener_get_base(struct evconnlistener *lev);//设置错误回调函数,监听发生错误的时候调用.(Libevent 2.0.8-rc)//错误回调函数的原型: typedef void (*evconnlistener_errorcb)(struct evconnlistener *lis, void *ptr);//void evconnlistener_set_error_cb(struct evconnlistener *lev,evconnlistener_errorcb errorcb);//下面是一个简单的echo server#include#include #include #include #include //客户端读回调函数.(从客户端读到数据,并且数据已经自动存到input buffer里面了).static void echo_read_cb(struct bufferevent *bev, void *ctx){ //分别从bufferevent里拿到 input buffer 和 output buffer. struct evbuffer *input = bufferevent_get_input(bev); struct evbuffer *output = bufferevent_get_output(bev); //将input buffer里面收到的数据全部搬到output buffer , libevent会为我们自动发送给客户端. evbuffer_add_buffer(output, input);}//客户端事件回调函数(发生错误或者客户端关闭).static void echo_event_cb(struct bufferevent *bev, short events, void *ctx){ if (events & BEV_EVENT_ERROR) perror("Error from bufferevent"); if (events & (BEV_EVENT_EOF | BEV_EVENT_ERROR)) { bufferevent_free(bev); }}//接受连接回调函数(接受到一个新连接.并且accept成功)static void accept_conn_cb(struct evconnlistener *listener, evutil_socket_t fd, struct sockaddr *address, int socklen,void *ctx){ struct event_base *base = evconnlistener_get_base(listener); //我们为新连接建立一个bufferevent来处理新连接. struct bufferevent *bev = bufferevent_socket_new(base, fd, BEV_OPT_CLOSE_ON_FREE); bufferevent_setcb(bev, echo_read_cb, NULL, echo_event_cb, NULL); bufferevent_enable(bev, EV_READ|EV_WRITE);}//接受连接发生错误回调函数.static void accept_error_cb(struct evconnlistener *listener, void *ctx){ struct event_base *base = evconnlistener_get_base(listener); int err = EVUTIL_SOCKET_ERROR(); fprintf(stderr, "Got an error %d (%s) on the listener. " "Shutting down.\n", err, evutil_socket_error_to_string(err)); event_base_loopexit(base, NULL);}int main(){ // struct event_base *base = event_base_new(); // int port = 9999; struct sockaddr_in sin; memset(&sin, 0, sizeof(sin)); sin.sin_family = AF_INET; sin.sin_addr.s_addr = htonl(0); sin.sin_port = htons(port); // struct evconnlistener *listener = evconnlistener_new_bind( base , accept_conn_cb , NULL , LEV_OPT_CLOSE_ON_FREE|LEV_OPT_REUSEABLE , -1 , (struct sockaddr*)&sin, sizeof(sin) ); // evconnlistener_set_error_cb(listener, accept_error_cb); // event_base_dispatch(base); // evconnlistener_free(listener); event_base_free(base);}
bufferevent
Libevent的evbuffer功能通过实现一个字节队列，在队列末尾添加数据，在队列头移除数据。
结构
struct bufferevent { struct event_base *ev_base; const struct bufferevent_ops *be_ops; struct event ev_read; struct event ev_write; struct evbuffer *input; struct evbuffer *output; …… bufferevent_data_cb readcb; bufferevent_data_cb writecb; bufferevent_event_cb errorcb; ……}; 创建基于套接字的bufferevent
基于套接字的bufferevent是最简单的，它使用libevent的底层事件机制来检测底层网络套接字是否已经就绪，可以进行读写操作，并且使用底层网络调用（如readv、writev、WSASend、WSARecv）来发送和接收数据。
struct bufferevent * bufferevent_socket_new(struct event_base *base, evutil_socket_t fd, int options);struct bufferevent *bev = bufferevent_socket_new(base, fd, BEV_OPT_CLOSE_ON_FREE); //例子
设置读写回调函数
void bufferevent_setcb(struct bufferevent *bufev, bufferevent_data_cb readcb, bufferevent_data_cb writecb, bufferevent_event_cb eventcb, void *cbarg);bufferevent_setcb(bev, readcb, NULL, errorcb, NULL); //例子
启用事件
int bufferevent_enable(struct bufferevent *bufev, short event);bufferevent_enable(bev, EV_READ|EV_WRITE); //例子
线程安全
默认情况下，多线程同时访问evbuffer是不安全的。如果您需要执行此操作，您可以在evbuffer上调用 evbuffer_enable_locking()函数。如果此函数的lock参数为 NULL，则 Libevent 通过evthread_set_lock_creation_callback函数分配一把新锁。否则，它所使用的参数作为该锁。
int evbuffer_enable_locking(struct evbuffer *buf, void *lock);void evbuffer_lock(struct evbuffer *buf);void evbuffer_unlock(struct evbuffer *buf);
实例
/* Example code: an echo server. */#include#include #include #include #include #include #include #include static voidecho_read_cb(struct bufferevent *bev, void *ctx){ /* 获取bufferevent中的读和写的指针 */ /* This callback is invoked when there is data to read on bev. */ struct evbuffer *input = bufferevent_get_input(bev); struct evbuffer *output = bufferevent_get_output(bev); /* 把读入的数据全部复制到写内存中 */ /* Copy all the data from the input buffer to the output buffer. */ evbuffer_add_buffer(output, input);}static void echo_event_cb(struct bufferevent *bev, short events, void *ctx){ if (events & BEV_EVENT_ERROR) perror("Error from bufferevent"); if (events & (BEV_EVENT_EOF | BEV_EVENT_ERROR)) { bufferevent_free(bev); }}static void accept_conn_cb(struct evconnlistener *listener,evutil_socket_t fd, struct sockaddr *address, int socklen,void *ctx){ /* 初始化一个bufferevent用于数据的写入和读取，首先需要从Listerner中获取event_base */ /* We got a new connection! Set up a bufferevent for it. */ struct event_base *base = evconnlistener_get_base(listener); struct bufferevent *bev = bufferevent_socket_new(base, fd, BEV_OPT_CLOSE_ON_FREE); /* 设置buferevent的回调函数，这里设置了读和事件的回调函数 */ bufferevent_setcb(bev, echo_read_cb, NULL, echo_event_cb, NULL); /* 启用该bufevent写和读 */ bufferevent_enable(bev, EV_READ|EV_WRITE);}static voidaccept_error_cb(struct evconnlistener *listener, void *ctx){ struct event_base *base = evconnlistener_get_base(listener); int err = EVUTIL_SOCKET_ERROR(); fprintf(stderr, "Got an error %d (%s) on the listener. ""Shutting down.\n", err, evutil_socket_error_to_string(err)); event_base_loopexit(base, NULL);}intmain(int argc, char **argv){ struct event_base *base; struct evconnlistener *listener; struct sockaddr_in sin; int port = 9876; if (argc > 1) { port = atoi(argv[1]); } if (port<=0 || port>65535) { puts("Invalid port"); return 1; } base = event_base_new(); /* 初始化event_base */ if (!base) { puts("Couldn't open event base"); return 1; } /* 初始化绑定地址 */ /* Clear the sockaddr before using it, in case there are extra * platform-specific fields that can mess us up. */ memset(&sin, 0, sizeof(sin)); /* This is an INET address */ sin.sin_family = AF_INET; / * Listen on 0.0.0.0 */ sin.sin_addr.s_addr = htonl(0); /* Listen on the given port. */ sin.sin_port = htons(port); /* 初始化evconnlistener(绑定地址、设置回调函数以及连接属性) */ listener = evconnlistener_new_bind(base, accept_conn_cb, NULL, LEV_OPT_CLOSE_ON_FREE|LEV_OPT_REUSEABLE, -1,(struct sockaddr*)&sin, sizeof(sin)); if (!listener) { perror("Couldn't create listener"); return 1; } /* 设置Listen错误回调函数 */ evconnlistener_set_error_cb(listener, accept_error_cb); / 开始accept进入循环 */ event_base_dispatch(base); return 0;}
http://blog.csdn.net/mhpmii/article/details/49583121