Nodejs事件引擎libuv源码剖析之:请求(request)结构的设计剖析
声明:本文为原创博文,转载请注明出处。
在libuv中,请求(request)代表一个用户向libuv发出的指令,比如uv_connect_s就表示一个tcp的连接请求、uv_work_s代表要递交给libuv线程池执行的任务请求、uv_write_s代表一个写请求。
类似于上一篇讲句柄(handle)那样,请求也由一个抽象基类和相应的子类组成,这个基类就是uv_req_s,下面来看一下它的定义:
1 /* Abstract base class of all requests. */ 2 struct uv_req_s { 3 /* public */ \ 4 void* data; \ 5 /* read-only */ \ 6 uv_req_type type; \ 7 /* private */ \ 8 void* active_queue[2]; \ 9 void* reserved[4]; \ 10 };
其中,data可以用来携带任何类型的用户数据;type为该请求的类型,其取值可以为:
1 typedef enum { 2 UV_UNKNOWN_REQ = 0, 3 UV_REQ, 4 UV_CONNECT, 5 UV_WRITE, 6 UV_SHUTDOWN, 7 UV_UDP_SEND, 8 UV_FS, 9 UV_WORK, 10 UV_GETADDRINFO, 11 UV_GETNAMEINFO, 12 UV_REQ_TYPE_PRIVATE, 13 UV_REQ_TYPE_MAX, 14 } uv_req_type;
active_queue是一个队列节点,该请求会通过该节点将自己挂载到所绑定的loop中的active_reqs队列上;该操作(添加、删除)主要通过uv__req_register和uv__req_unregister两个宏定义实现:
1 #define uv__req_register(loop, req) \ 2 do { \ 3 QUEUE_INSERT_TAIL(&(loop)->active_reqs, &(req)->active_queue); \ 4 } \ 5 while (0) 6 7 #define uv__req_unregister(loop, req) \ 8 do { \ 9 assert(uv__has_active_reqs(loop)); \ 10 QUEUE_REMOVE(&(req)->active_queue); \ 11 } \ 12 while (0)
用户并不会直接使用以上两个宏,而是会使用uv__req_init来初始化一个请求,该函数实现如下:
void uv__req_init(uv_loop_t* loop, uv_req_t* req, uv_req_type type) { uv_req_init(loop, req); req->type = type; uv__req_register(loop, req);//注册这个req }
请求并不会单独被处理,一个请求除了会被挂载在loop->active_reqs上,每个req都会被赋值给相应的句柄中的成员。下面画图libuv中各个请求中的关系,其中横线以上的为抽象基类,横线以下都是uv_req_t的直接子类。