libevent（12）bufferevent的基础知识

最新推荐文章于 2024-08-06 18:45:00 发布

原创

最新推荐文章于 2024-08-06 18:45:00 发布 · 1.1k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#服务器 #网络 #libevent #bufferevent

bufferevent是libevent库中的一个关键组件，它提供了一种抽象的IO操作方式，简化了socket的读写。每个bufferevent包含读写缓冲区，使用回调函数处理数据读写事件，并可通过设置水位控制回调触发条件。此外，文章还介绍了bufferevent的创建、启用/禁用、设置回调、读写操作、超时管理和释放等接口。

一、bufferevent的基本概念

bufferevent 是 libevent 中的一个事件缓冲 IO，内部实现了基本 socket recv/send 操作，用户只需要调用 bufferevent 的 API 即可实现数据的读写。

（1）缓冲区：每个 bufferevent 都有一个读缓冲区（input）和写缓冲区（output），数据结构为 evbuffer ，它是一个数据缓冲区，用于缓存网络上发送或接收的数据。

（2）回调：

// 读取和写入回调
typedef void (*bufferevent_data_cb)(struct bufferevent *bev, void *ctx);

// 事件回调，其中what表示发生的事件，具体后面有说明
typedef void (*bufferevent_event_cb)(struct bufferevent *bev, short what, void *ctx);

（3）水位：可以通过设置水位来调节回调函数的调用。

（3.1）读取低水位：输入缓冲区的数据量达到或超过此水位时，调用回调函数，即数据量达不到水位要求，则不会调用回调；

（3.2）读取高水位：输入缓冲区的数据量达到此水位时，bufferevent 将停止读取，直到输入缓冲区中的数据被读取，使得数据量低于此水位。注意用于限制一次读取的最大数据量。

（3.3）写入低水位：输出缓冲区中的数据量达到或低于此水位时，写入回调将被调用；

（3.4）写入高水位：不设置，直接写入即可，一般不用。

默认情况下，读取低水位和高水位都为 0，表示有数据就读取，且不会限定最大读取数量。写入的水位也是一样，表示可写即会全部写入。