libevent库学习 bufferevent

介绍

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;
}

编译运行