介绍
Libevent 是一个用C语言编写的、轻量级的开源高性能事件通知库,主要有以下几个亮点:事件驱动( event-driven),高性能;轻量级,专注于网络,不如 ACE 那么臃肿庞大;源代码相当精炼、易读;跨平台,支持 Windows、 Linux、 *BSD 和 Mac Os;支持多种 I/O 多路复用技术, epoll、 poll、 dev/poll、 select 和 kqueue 等;支持 I/O,定时器和信号等事件;注册事件优先级。
Libevent 已经被广泛的应用,作为底层的网络库;比如 memcached、 Vomit、 Nylon、 Netchat等等。
bufferevent
libevent为此提供了一种通用机制,即 bufferevent。bufferevent由一个底层的传输端口(如套接字),一个读取缓冲区和一个写入缓冲区组成。与通常的事件在底层传输端口已经就绪,可以读取或者写入的时候执行回调不同的是,bufferevent 在读取或者写入了足够量的数据之后调用用户提供的回调。
创建bufferevent
struct bufferevent *bufferevent_socket_new(struct event_base *base,
evutil_socket_t fd,
enum bufferevent_options options);
// base: event_base
// fd: 封装到bufferevent内的 fd
// options:BEV_OPT_CLOSE_ON_FREE
// 返回: 成功创建的 bufferevent事件对象。
释放bufferevent
void bufferevent_socket_free(struct bufferevent *ev);
// ev:bufferevent_socket_new函数的返回值
设置bufferevent 的回调函数
void bufferevent_setcb(struct bufferevent * bufev,
bufferevent_data_cb readcb,
bufferevent_data_cb writecb,
bufferevent_event_cb eventcb,
void *cbarg );
// bufev: bufferevent_socket_new() 返回值
// readcb: 设置 bufferevent 读缓冲,对应回调 read_cb{ bufferevent_read() 读数据 }
// writecb: 设置 bufferevent 写缓冲,对应回调 write_cb { } -- 给调用者,发送写成功通知。 可以 NULL
// eventcb: 设置 事件回调。 也可传NULL
// cbarg: 上述回调函数使用的 参数。
// 读回调函数
typedef void (*bufferevent_data_cb)(struct bufferevent *bev, void*ctx);
void read_cb(struct bufferevent *bev, void *cbarg )
{
.....
bufferevent_read(); --- read();
}
size_t bufferevent_read(struct bufferevent *bev, void *buf, size_t bufsize);
// 写回调
// write 回调函数类型:
int bufferevent_write(struct bufferevent *bufev, const void *data, size_t size);
简单的使用
#include<stdio.h>
#include<unistd.h>
#include<stdlib.h>
#include<sys/types.h>
#include<sys/stat.h>
#include<string.h>
#include<event2/event.h>
#include<event2/listener.h>
#include<event2/bufferevent.h>
#include<iostream>
using std::cout;
using std::endl;
void read_cb(struct bufferevent *bev,void *arg){
char buf[1024];
bufferevent_read(bev,buf,sizeof(buf));
cout<<"client says:"<<buf<<endl;
char *p="server received\n";
bufferevent_write(bev,p,strlen(p)+1);
sleep(1);
}
void write_cb(struct bufferevent *bev,void *arg){
cout<<"server write data to client, write buffer callback"<<endl;
}
void event_cb(struct bufferevent *bev,short events,void* arg){
if(events & BEV_EVENT_EOF){
cout<<"connection closed"<<endl;
}else if(events & BEV_EVENT_ERROR ){
cout<<"some other error"<<endl;
}
bufferevent_free(bev);
cout<<"bufferevent resource has freed"<<endl;
}
void listener_cb(struct evconnlistener* listener,
evutil_socket_t fd,
struct sockaddr* addr,
int len,void *ptr){
cout<<"connecting to client"<<endl;
struct event_base* base=(struct event_base*)ptr;
struct bufferevent* bev=bufferevent_socket_new(base,fd,BEV_OPT_CLOSE_ON_FREE);
bufferevent_setcb(bev,read_cb,write_cb,event_cb,NULL);
bufferevent_enable(bev,EV_READ);
}
int main(){
struct event_base* base=event_base_new();
struct sockaddr_in server_addr;
memset(&server_addr,0,sizeof(server_addr));
server_addr.sin_family=AF_INET;
server_addr.sin_port=htons(9527);
server_addr.sin_addr.s_addr=htonl(INADDR_ANY);
struct evconnlistener* listener=NULL;
listener=evconnlistener_new_bind(base,listener_cb,base,
LEV_OPT_CLOSE_ON_FREE|LEV_OPT_REUSEABLE,
-1,(struct sockaddr *)&server_addr,sizeof(server_addr));
event_base_dispatch(base);
evconnlistener_free(listener);
event_base_free(base);
return 0;
}
编译运行