libevent 学习：官方案例hello-world

路径：libevent-2.1.8-stable/sample

文件 hello-world.c

这个案例实现的是一个简单的服务器，监听9995端口的连接请求，当一个连接请求到来，回显一个 “Hello, World!”，

当收到中断信号（例如前台执行时的ctrl + c），则退出。

#include <string.h>
#include <errno.h>
#include <stdio.h>
#include <signal.h>
#ifndef _WIN32
#include <netinet/in.h>
# ifdef _XOPEN_SOURCE_EXTENDED
#  include <arpa/inet.h>
# endif
#include <sys/socket.h>
#endif

#include <event2/bufferevent.h>
#include <event2/buffer.h>
#include <event2/listener.h>
#include <event2/util.h>
#include <event2/event.h>

static const char MESSAGE[] = "Hello, World!\n";

static const int PORT = 9995;

static void listener_cb(struct evconnlistener *, evutil_socket_t,
    struct sockaddr *, int socklen, void *);
static void conn_writecb(struct bufferevent *, void *);
static void conn_eventcb(struct bufferevent *, short, void *);
static void signal_cb(evutil_socket_t, short, void *);

int
main(int argc, char **argv)
{
	struct event_base *base;
	struct evconnlistener *listener;
	struct event *signal_event;

	struct sockaddr_in sin;
#ifdef _WIN32
	WSADATA wsa_data;
	WSAStartup(0x0201, &wsa_data);
#endif

	base = event_base_new();
	if (!base) {
		fprintf(stderr, "Could not initialize libevent!\n");
		return 1;
	}

	memset(&sin, 0, sizeof(sin));
	sin.sin_family = AF_INET;
	sin.sin_port = htons(PORT);

	listener = evconnlistener_new_bind(base, listener_cb, (void *)base,
	    LEV_OPT_REUSEABLE|LEV_OPT_CLOSE_ON_FREE, -1,
	    (struct sockaddr*)&sin,
	    sizeof(sin));

	if (!listener) {
		fprintf(stderr, "Could not create a listener!\n");
		return 1;
	}

	signal_event = evsignal_new(base, SIGINT, signal_cb, (void *)base);

	if (!signal_event || event_add(signal_event, NULL)<0) {
		fprintf(stderr, "Could not create/add a signal event!\n");
		return 1;
	}

	event_base_dispatch(base);

	evconnlistener_free(listener);
	event_free(signal_event);
	event_base_free(base);

	printf("done\n");
	return 0;
}

static void
listener_cb(struct evconnlistener *listener, evutil_socket_t fd,
    struct sockaddr *sa, int socklen, void *user_data)
{
	struct event_base *base = user_data;
	struct bufferevent *bev;

	bev = bufferevent_socket_new(base, fd, BEV_OPT_CLOSE_ON_FREE);
	if (!bev) {
		fprintf(stderr, "Error constructing bufferevent!");
		event_base_loopbreak(base);
		return;
	}
	bufferevent_setcb(bev, NULL, conn_writecb, conn_eventcb, NULL);
	bufferevent_enable(bev, EV_WRITE);
	bufferevent_disable(bev, EV_READ);

	bufferevent_write(bev, MESSAGE, strlen(MESSAGE));
}

static void
conn_writecb(struct bufferevent *bev, void *user_data)
{
	struct evbuffer *output = bufferevent_get_output(bev);
	if (evbuffer_get_length(output) == 0) {
		printf("flushed answer\n");
		bufferevent_free(bev);
	}
}

static void
conn_eventcb(struct bufferevent *bev, short events, void *user_data)
{
	if (events & BEV_EVENT_EOF) {
		printf("Connection closed.\n");
	} else if (events & BEV_EVENT_ERROR) {
		printf("Got an error on the connection: %s\n",
		    strerror(errno));/*XXX win32*/
	}
	/* None of the other events can happen here, since we haven't enabled
	 * timeouts */
	bufferevent_free(bev);
}

static void
signal_cb(evutil_socket_t sig, short events, void *user_data)
{
	struct event_base *base = user_data;
	struct timeval delay = { 2, 0 };

	printf("Caught an interrupt signal; exiting cleanly in two seconds.\n");

	event_base_loopexit(base, &delay);
}

编译：

gcc hello-world.c -levent -o helloserver

运行：

./helloserver

用python编写一个简单的客户端测试这个server：

#!/usr/bin/python3                                    
import socket
address = ('127.0.0.1', 9995)
s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
s.connect(address)
while 1:
    data = s.recv(64)
    if  data:
        print (data)
    else:
        break
s.close()

看看这个hello-world.c 代码都用了啥（这个helloworld感觉不太helloworld）

结构体：

• event_base：是维护Libevent 的事件循环信息和状态的结构体
• evconnlistener：可以理解为libevent 的监听套接字结构体
• event：代表一个事件的结构
• sockaddr_in：这个是socket 编程的地址结构体了
• bufferevent：用于处理IO事件的缓冲区

函数：

• event_base_new：用于创建一个默认配置的event_base 对象
• evconnlistener_new_bind：将一个event_base_new绑定到指定的ip地址，可指定客户端连接回调事件，返回一个 evconnlistener；
• evsignal_new：创建一个事件，指定事件关联的信号和回调函数，加到时间循环 event_base 里
• event_add：将事件加入到等待队列，可设置最大等待事件，时间NULL表示一直等待
• event_base_dispatch：开启时间循环，直到没有新注册事件，或者event_base_loopbreak() ， event_base_loopexit() 调用
• evconnlistener_free：释放一个evconnlistener
• event_free：析构一个event
• event_base_free：析构与event_base相关的内存，并释放event_base
• bufferevent_socket_new：在一个已有的socket上创建一个 bufferevent
• event_base_loopbreak：跳出 event_base  所代表的事件循环
• bufferevent_setcb：设置bufferevent 对应的读写回调函数
• bufferevent_enable：使能 bufferevent 的事件
• bufferevent_disable：关闭 bufferevent 的事件
• bufferevent_write：将数据写入bufferevent  的缓冲区
• bufferevent_get_output：返回bufferevent对应的输出缓冲
• evbuffer_get_length：返回缓冲区内的总字节数
• bufferevent_free：释放 bufferevent  的空间
• event_base_loopexit：在指定时间点后跳出事件循环

 

参考：

libevent Documentation