08libevent库下通信服务端与客户端的主要函数

最新推荐文章于 2023-05-13 11:00:32 发布

Mango酱

最新推荐文章于 2023-05-13 11:00:32 发布

阅读量294

点赞数

分类专栏： Linux网络编程文章标签：网络 linux c语言

本文链接：https://blog.csdn.net/weixin_44517656/article/details/108781638

版权

Linux网络编程专栏收录该内容

28 篇文章 5 订阅

订阅专栏

08libevent库下通信服务端与客户端的主要函数

1 服务端的主要函数
1）evconnlistener_new()，该函数了解一下即可，它的功能相当于new一个监听者对象而已，并无实际封装，你看参6fd就知道，仍然需要自己socket()的返回值传参。所以主要用下面那个。

     struct evconnlistener * evconnlistener_new( 
               struct event_base *base,                 
               evconnlistener_cb cb,		//监听到有连接过来后，触发该回调函数
               void *ptr,					//回调函数参数，一般传base，因为回调中要使用，但是却没有该base
               unsigned flags, 				//可识别的标志位
               int backlog, 				//相当于listen函数的监听数,-1默认使用最大值
               evutil_socket_t fd			//需要socket()的返回值，所以该函数基本很少用，因为封装后没省略多少步骤。
);

//flags:
//LEV_OPT_CLOSE_ON_FREE ：BEV_OPT_CLOSE_ON_FREE 释放 bufferevent 时关闭底层传输端口，这将关闭底层套接字，释放bufferevent对象等。对比bufferevent_socket_new的参数3enum bufferevent_options options

//LEV_OPT_REUSEABLE：端口复用,选用多个flags时，可使用 "|"

2）evconnlistener_new_bind()，此函数相当于socket、bind、listen、accpet四个函数，方便吧比起上面的。

    struct evconnlistener *evconnlistener_new_bind(
                struct event_base *base, 
                evconnlistener_cb cb, 		//监听到有连接过来后，触发该回调函数
                void *ptr,					//回调函数参数，一般传base，因为回调中要使用，但是却没有该base
                unsigned flags,				//看上面
                int backlog,				
                const struct sockaddr *sa, 	//服务端地址
                int socklen
    );

3）上面两个函数的回调函数类型

        typedef void (*evconnlistener_cb)( 
                struct evconnlistener *listener, 	//上面函数的监听者返回值
                evutil_socket_t sock,				//用于通信的套接字cfd，不需要你管，libevent会帮你传参，你只需要在该回调函数中使用即可
                struct sockaddr *addr,				//上面的服务器地址
                int len,
                void *ptr							//evconnlistener_new_bind的参数3，实际上这个回调函数的最后三个参数都是evconnlistener_new_bind的参数
);

4）evconnlistener_free监听者事件对象的释放

void evconnlistener_free(struct evconnlistener *lev);

5）管理监听者的监听，设置监听者是启用还是禁用，通过这两个函数的配合，可以在某一处可能触发危险的地方关闭监听，度过危险后然后再启动监听。

        int evconnlistener_enable(struct evconnlistener *lev);
        int evconnlistener_disable(struct evconnlistener *lev);

6）重新设置监听者事件的回调函数和其参数。

        void evconnlistener_set_cb( 
            struct evconnlistener *lev,
            evconnlistener_cb cb,
            void *arg 
);

2 客户端的主要函数
1）bufferevent_socket_new，实际上之前的文章已经说过这个函数了。

    struct bufferevent *bev = bufferevent_socket_new(base, -1, BEV_OPT_CLOSE_ON_FREE);

2）bufferevent_socket_connect()，它与connect函数一模一样。下面注释详解这个函数的功能。

         int bufferevent_socket_connect( 
         				 struct bufferevent *bev,	//上面的bufferevent对象
                         struct sockaddr *address,  //服务端地址
                         int addrlen 
        );

//1 bufferevent 若未设置套接字,该函数将为其分配一个新的流套接字, 并且设置状态为非阻塞

//2 bufferevent 已设置套接字,调用 bufferevent_socket_connect() 将告知libevent 套接字还未连接,直到连接成功之前不应该对其进行读取或者写入操作。更好的维护了bufferevent缓冲的操作权限。

//3 连接完成之后可以向输出缓冲区添加数据