libevent從入門到掌握五

libevent從入門到掌握<五>

鏈接監聽器evconnlistener

evconnlistener 機制提供了監聽和接受 TCP 連接的方法

---

創建和釋放evconnlistener

struct evconnlistener *
evconnlistener_new(struct event_base *base,
    evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,
    evutil_socket_t fd);

struct evconnlistener *
evconnlistener_new_bind(struct event_base *base,
    evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,
    const struct sockaddr *sa, int socklen);

void evconnlistener_free(struct evconnlistener *lev);

兩個 evconnlistener_new*()函數都分配和返回一個新的連接監聽器對象。連接監聽器使 用 event_base 來得知什麼時候在給定的監聽套接字上有新的 TCP 連接。新連接到達時,監聽 器調用你給出的回調函數。

兩個函數中,base參數都是監聽器用於監聽連接的 event_base。cb是收到新連接時要調 用的回調函數;

如果 cb 爲 NULL,則監聽器是禁用的,直到設置了回調函數爲止。

ptr 指針將傳遞給回調函數。

flags 參數控制回調函數的行爲,下面會更詳細論述。

backlog 是任何 時刻網絡棧允許處於還未接受狀態的最大未決連接數。

更多細節請查看系統的 listen()函數文檔。

如果 backlog 是負的,libevent 會試圖挑選一個較好的值 ; 如果爲0,libevent 認爲已 經對提供的套接字調用了listen()。

---

兩個函數的不同在於如何建立監聽套接字。 evconnlistener_new()函數假定已經將套接字綁定到要監聽的端口,然後通過 fd 傳入這個套接字。

如果要 libevent 分配和綁定套接字,可以調用 evconnlistener_new_bind() ,傳輸要綁定到的地址和地址長度。

要釋放連接監聽器,調用 evconnlistener_free()。

---

可識別的標誌

可以給 evconnlistener_new() 函數的 flags 參數傳入一些標誌。可以用或 (OR)運算任意連接 下述標誌:

• LEV_OPT_LEAVE_SOCKETS_BLOCKING

默認情況下,連接監聽器接收新套接字後,會將其設置爲非阻塞的,以便將其用於 libevent。如果不想要這種行爲,可以設置這個標誌。

• LEV_OPT_CLOSE_ON_FREE

如果設置了這個選項,釋放連接監聽器會關閉底層套接字。

• LEV_OPT_CLOSE_ON_EXEC

如果設置了這個選項,連接監聽器會爲底層套接字設置 close-on-exec 標誌。更多信息請查 看 fcntl 和 FD_CLOEXEC 的平臺文檔。

• LEV_OPT_REUSEABLE

某些平臺在默認情況下 ,關閉某監聽套接字後 ,要過一會兒其他套接字纔可以綁定到同一個 端口。設置這個標誌會讓 libevent 標記套接字是可重用的,這樣一旦關閉,可以立即打開其 他套接字,在相同端口進行監聽。

• LEV_OPT_THREADSAFE

爲監聽器分配鎖,這樣就可以在多個線程中安全地使用了。這是 2.0.8-rc 的新功能。

---

鏈接監聽器回調

typedef void (*evconnlistener_cb)(struct evconnlistener *listener,
    evutil_socket_t sock, struct sockaddr *addr, int len, void *ptr);

接收到新連接會調用提供的回調函數 。

listener 參數是接收連接的連接監聽器 。

sock 參數是 新接收的套接字。

addr 和 len 參數是接收連接的地址和地址長度。

ptr 是調 用 evconnlistener_new() 時用戶提供的指針。

---

啓用和禁用 evconnlistener

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

這兩個函數暫時禁止或者重新允許監聽新連接。

---

調整 evconnlistener 的回調函數

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

函數調整 evconnlistener 的回調函數和其參數。

---

案例：（來源網上https://my.oschina.net/mickelfeng/blog/1514488）

cli.cpp

#include<sys/types.h>  
#include<sys/socket.h>  
#include<netinet/in.h>  
#include<arpa/inet.h>  
#include<errno.h>  
#include<unistd.h>  
  
#include<stdio.h>  
#include<string.h>  
#include<stdlib.h>  
  
#include<event.h>  
#include<event2/bufferevent.h>  
#include<event2/buffer.h>  
#include<event2/util.h>  
  
  
  
  
int tcp_connect_server(const char* server_ip, int port);  
  
  
void cmd_msg_cb(int fd, short events, void* arg);  
void server_msg_cb(struct bufferevent* bev, void* arg);  
void event_cb(struct bufferevent *bev, short event, void *arg);  
  
int main(int argc, char** argv)  
{  
    if( argc < 3 )  
    {  
        //兩個參數依次是服務器端的IP地址、端口號  
        printf("please input 2 parameter\n");  
        return -1;  
    }  
  
    struct event_base *base = event_base_new();  
  
    struct bufferevent* bev = bufferevent_socket_new(base, -1,  
                                                     BEV_OPT_CLOSE_ON_FREE);  
  
    //監聽終端輸入事件  
    struct event* ev_cmd = event_new(base, STDIN_FILENO,  
                                     EV_READ | EV_PERSIST,  
                                     cmd_msg_cb, (void*)bev);  
  
  
    event_add(ev_cmd, NULL);  
  
    struct sockaddr_in server_addr;  
  
    memset(&server_addr, 0, sizeof(server_addr) );  
  
    server_addr.sin_family = AF_INET;  
    server_addr.sin_port = htons(atoi(argv[2]));  
    inet_aton(argv[1], &server_addr.sin_addr);  
  
    bufferevent_socket_connect(bev, (struct sockaddr *)&server_addr,  
                               sizeof(server_addr));  
  
  
    bufferevent_setcb(bev, server_msg_cb, NULL, event_cb, (void*)ev_cmd);  
    bufferevent_enable(bev, EV_READ | EV_PERSIST);  
  
  
  
    event_base_dispatch(base);  
  
    printf("finished \n");  
    return 0;  
}  
  
  
  
  
  
void cmd_msg_cb(int fd, short events, void* arg)  
{  
    char msg[1024];  
  
    int ret = read(fd, msg, sizeof(msg));  
    if( ret < 0 )  
    {  
        perror("read fail ");  
        exit(1);  
    }  
  
    struct bufferevent* bev = (struct bufferevent*)arg;  
  
    //把終端的消息發送給服務器端  
    bufferevent_write(bev, msg, ret);  
}  
  
  
void server_msg_cb(struct bufferevent* bev, void* arg)  
{  
    char msg[1024];  
  
    size_t len = bufferevent_read(bev, msg, sizeof(msg));  
    msg[len] = '\0';  
  
    printf("recv %s from server\n", msg);  
}  
  
  
void event_cb(struct bufferevent *bev, short event, void *arg)  
{  
  
    if (event & BEV_EVENT_EOF)  
        printf("connection closed\n");  
    else if (event & BEV_EVENT_ERROR)  
        printf("some other error\n");  
    else if( event & BEV_EVENT_CONNECTED)  
    {  
        printf("the client has connected to server\n");  
        return ;  
    }  
  
    //這將自動close套接字和free讀寫緩衝區  
    bufferevent_free(bev);  
  
    struct event *ev = (struct event*)arg;  
    event_free(ev);  
}

ser.cpp

#include<netinet/in.h>    
#include<sys/socket.h>    
#include<unistd.h>    
    
#include<stdio.h>    
#include<string.h>    
    
#include<event.h>    
#include<event2/listener.h>    
#include<event2/bufferevent.h>    
//#include<thread.h>    
    
    
void listener_cb(evconnlistener *listener, evutil_socket_t fd,    
                 struct sockaddr *sock, int socklen, void *arg);    
    
void socket_read_cb(bufferevent *bev, void *arg);    
void socket_event_cb(bufferevent *bev, short events, void *arg);    
    
int main()    
{    
    //evthread_use_pthreads();//enable threads    
    
    struct sockaddr_in sin;    
    memset(&sin, 0, sizeof(struct sockaddr_in));    
    sin.sin_family = AF_INET;    
    sin.sin_port = htons(9999);    
    
    event_base *base = event_base_new();    
    evconnlistener *listener    
            = evconnlistener_new_bind(base, listener_cb, base,    
                                      LEV_OPT_REUSEABLE|LEV_OPT_CLOSE_ON_FREE,    
                                      10, (struct sockaddr*)&sin,    
                                      sizeof(struct sockaddr_in));    
    
    event_base_dispatch(base);    
    
    evconnlistener_free(listener);    
    event_base_free(base);    
    
    return 0;    
}    
    
    
//一個新客戶端連接上服務器了    
//當此函數被調用時，libevent已經幫我們accept了這個客戶端。該客戶端的  
//文件描述符爲fd  
void listener_cb(evconnlistener *listener, evutil_socket_t fd,    
                 struct sockaddr *sock, int socklen, void *arg)    
{    
    printf("accept a client %d\n", fd);    
    
    event_base *base = (event_base*)arg;    
    
    //爲這個客戶端分配一個bufferevent    
    bufferevent *bev =  bufferevent_socket_new(base, fd,    
                                               BEV_OPT_CLOSE_ON_FREE);    
    
    bufferevent_setcb(bev, socket_read_cb, NULL, socket_event_cb, NULL);    
    bufferevent_enable(bev, EV_READ | EV_PERSIST);    
}    
    
    
void socket_read_cb(bufferevent *bev, void *arg)    
{    
    char msg[4096];    
    
    size_t len = bufferevent_read(bev, msg, sizeof(msg)-1 );    
    
    msg[len] = '\0';    
    printf("server read the data %s\n", msg);    
    
    char reply[] = "I has read your data";    
    bufferevent_write(bev, reply, strlen(reply) );    
}    
    
    
void socket_event_cb(bufferevent *bev, short events, void *arg)    
{    
    if (events & BEV_EVENT_EOF)    
        printf("connection closed\n");    
    else if (events & BEV_EVENT_ERROR)    
        printf("some other error\n");    
    
    //這將自動close套接字和free讀寫緩衝區    
    bufferevent_free(bev);    
}

---

想了解學習更多C++後臺服務器方面的知識，請關注：
微信公衆號：C++後臺服務器開發

---