bufferevent主要就是服务于网络通信
bufferevent的特性:
bufferevent是带有buf的事件:
头文件#include<event2/bufferevent.h>
原理:bufferevent有两个缓冲区,用队列实现,先进先出
读:有数据—> 读的回调函数被调用 —> 使用bufferevent_read() —>读数据
写:使用bufferevent_write() —> 向缓冲区中写数 —> 该缓冲区有数据自动写出 —> 写完,回调函数被调用
带缓冲区的事件创建、缓冲
创建: struct bufferevent bufferevent_socket_new(struct event_base *base, evutil_socket_t fd, enum bufferevent_options options);
*
1,base;
2,fd封装到bufferevent内的fd;
3,options:基本就用BEV_OPT_CLOSE_ON_FREE,表示释放bufferevent时关闭底层传输端口,即关闭底层套接字,释放底层bufferevent等
返回:成功创建bufferevent事件对象
销毁void bufferevent_socket_free(struct bufferevent *ev);
给bufferevent事件对象设置回调
对比event:
event_new(fd, callback);------->创建ev中自带cb,event_add再挂到event_base上即可
bufferevent_socket_new(fd) 没有cb所以需要再一个函数用于来专门设置回调bufferevent_setcb(callback)
因为有两个缓冲区,所以要设置读写回调函数,并加一个事件回调函数
void bufferevent_setcb(struct bufferevent *bufev,
bufferevent_data_cb readcb, bufferevent_data_cb writecb,
bufferevent_event_cb eventcb, void *cbarg);
bufev:缓冲区事件
readcb:设置bufferevent读缓冲,对应回调read_cb{bufferevent_read() 读数据 }
writecb:设置bufferevent写缓冲,对应回调write_cb{ }—给调用者发送写成功通知,可以NULL
eventcb:设置事件回调。也可传NULL
回调函数类型:typedef void (*bufferevent_data_cb)(struct bufferevent *bev, void *ctx);
read回调函数:
void read_cb(struct bufferevent *bev, void *cbarg)
{
...
bufferevent_read();
}
其中bufferevent_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);
禁用和启用缓冲区
默认: 新建的bufferevent写缓冲是enable,而读缓冲是disable的
1,void bufferevent_enable(struct bufferevent *bufev, short events);
启用缓冲区
2,void bufferevent_disable(struct bufferevent * bufev, short events);
禁用
3,short bufferevent_get_enabled(struct bufferevent *bufev);
获取缓冲区的禁用状态,需要借助&来得到
其中第二个参数events可以取EV_READ、EV_WRITE、EV_READ|EV_WRITE
bufferevent的网络通信知识前提:
客户端和服务器连接和监听⭐
客户端:
socket(); connect() ----->
int bufferevent_socket_connect(struct bufferevent *bev, struct sockaddr *address, int addrlen);
参数1; bev = bufferevent 事件对象(封装了fd)
参数2/3的 address、len等同于connect()的参数2/3
服务器:
socket(); bind(); listen(); accept(); ----->
evconnlistener_new_bind()
这个函数可以完成系统调用socket(); bind(); listen(); accept();
四个函数的作用
#include<event2/listener.h>
...
//服务器创建监听器
struct evconnlistener *evconnlistener_new_bind(
struct event_base *base,
evconnlistener_cb cb,//监听回调函数,接收连接之后,用户要做的操作
void *ptr,//回调函数的参数
unsigned flags,//可以识别的标志
int backlog,//时listen()函数的第二个参数,即同时连接的最大数,传-1就表示使用默认的最大值128
const struct sockaddr *sa,//服务器+Port,是一个传入函数,是服务器自己的地址结构
int socklen//sa的大小
);
flags可取值:
LEV_OPT_CLOSE_ON_FREE
释放bufferevent时关闭底层传输端口,这将关闭底层套接字,释放底层bufferevent等
LEV_OPT_REUSEABLE
端口复用,可以“|”
返回值:struct evconnlistener *listener
成功创建的监听器
回调函数,一旦被回调,说明在其内部应该与客户端完成数据读写操作进行通信
回调函数类型:【注意】该回调函数不是由我们调用的,是框架自动调用
typedef void (*evconnlistener_cb)(
struct evconnlistener *listener,//上面监听器evconnlistener_new_bind函数的返回值
evutil_socket sock,//用于通信的文件描述符
struct sockaddr *addr,//客户端IP+端口
int len,//客户端地址的长度
void *ptr;//外部传来的回调函数要用的参数
);