struct bufferevent定义在文件bufferevent_struct.h中。
1 /** 2 Shared implementation of a bufferevent. 3 4 This type is exposed only because it was exposed in previous versions, 5 and some people's code may rely on manipulating it. Otherwise, you 6 should really not rely on the layout, size, or contents of this structure: 7 it is fairly volatile, and WILL change in future versions of the code. 8 **/ 9 struct bufferevent { 10 /** Event base for which this bufferevent was created. */ 11 struct event_base *ev_base; 12 /** Pointer to a table of function pointers to set up how this 13 bufferevent behaves. */ 14 const struct bufferevent_ops *be_ops; 15 16 /** A read event that triggers when a timeout has happened or a socket 17 is ready to read data. Only used by some subtypes of 18 bufferevent. */ 19 struct event ev_read; 20 /** A write event that triggers when a timeout has happened or a socket 21 is ready to write data. Only used by some subtypes of 22 bufferevent. */ 23 struct event ev_write; 24 25 /** An input buffer. Only the bufferevent is allowed to add data to 26 this buffer, though the user is allowed to drain it. */ 27 struct evbuffer *input; 28 29 /** An input buffer. Only the bufferevent is allowed to drain data 30 from this buffer, though the user is allowed to add it. */ 31 struct evbuffer *output; 32 33 struct event_watermark wm_read; 34 struct event_watermark wm_write; 35 36 bufferevent_data_cb readcb; 37 bufferevent_data_cb writecb; 38 /* This should be called 'eventcb', but renaming it would break 39 * backward compatibility */ 40 bufferevent_event_cb errorcb; 41 void *cbarg; 42 43 struct timeval timeout_read; 44 struct timeval timeout_write; 45 46 /** Events that are currently enabled: currently EV_READ and EV_WRITE 47 are supported. */ 48 short enabled; 49 };
libevent中的event结构对应套接字的某一个事件,读或者写,bufferevent结构对应一个套接字,其中有两个event结构:evread、evwrite。
对bufferevent的操作主要有:
1、bufferevent_socket_new,分配一个bufferevent对象并初始化,该函数内部依次调用了bufferevent_init_common_、event_assign(evread)、event_assign(evwrite),在该函数中只是初始化了读写事件,并没有调用event_add,两个事件的回调函数分别是定义在bufferevent_socket.c中的bufferevent_readcb、bufferevent_writecb,传递的参数是bufferevent指针。
2、bufferevent_new,分配一个bufferevent对象并设置回调,该函数的实现其实是依次调用了bufferevent_socket_new和bufferevent_setcb。
3、bufferevent_setcb,为bufferevent结构设置readcb、writecb、eventcb。
4、bufferevent_init_common_,初始化bufferevent公共的部分成员,例如:be_ops(设置bufferevent的行为)。
5、bufferevent_enable,使bufferevent生效(前面说过,初始化的时候并未调用event_add),该函数调用bufferevent的成员be_ops.enable,根据上面bufferevent_init_common_函数可知,enable实际调用了bufferevent_ops_socket.be_socket_enable,be_socket_enable调用了bufferevent_add_event_函数,bufferevent_add_event_函数调用了event_add。所以由此可以得知,使得evread、evwrite事件有效的函数是bufferevent_enable。
6、bufferevent_disable,使bufferevent失效,该函数调用关系类似于bufferevent_enable,bufferevent_disable->bufferevent.be_ops->bufferevent_ops_socket.be_socket_disable->event_del。
按照我对libevent的理解,evwrite在写完数据应该是被设置为无效的,因为正常情况下,一个套接字一直是可写的,所以写事件一直是有效的,所以需要找到bufferevent是怎么管理evread、evwrite事件的。
bufferevent的作用就是对数据的读写做一个缓存,所以调用bufferevent_setcb函数传入的readcb、writecb、eventcb三个回调函数,其中readcb应该是读取了一些数据之后被回调的,此时数据已经被读取到了evbuffer中;而writecb应该是写入了一些数据之后被回调的,此时应该应该已经将evwrite设置为无效的了,应该在调用完send之后执行的。bufferevent封装了底层的recv和send。
在调用bufferevent_socket_new中,调用了evbuffer_add_cb函数为output(对应输出的evbuffer)设置了相应的回调函数bufferevent_socket_outbuf_cb,在该函数中调用了bufferevent_add_event_,从上面的分析可以知道该函数会使evwrite事件生效,也就是开始监听可读事件,所以这里是使evwrite生效的地方。
在bufferevent_writecb中,可以找到当output中没有数据时,确实调用了bufferevent_disable,所以这里就是使evwrite失效的地方,由此跟我上面的推测一样。
到这里,关于bufferevent的分析就结束了。