Nginx中封装的数据结构

整型

typedef intptr_t        ngx_int_t;
typedef uintptr_t       ngx_uint_t;

ngx_str_t【字符串】

typedef struct {size_t      len; // 表示字符串的有效长度u_char     *data;// 表示字符串起始地址
} ngx_str_t;

ngx_list_t【链表】

typedef struct ngx_list_part_s  ngx_list_part_t;// 表示链表中的一个元素
struct ngx_list_part_s {void             *elts; // 指向数组的起始位置ngx_uint_t        nelts;//  表示数组中已经使用了多少个元素ngx_list_part_t  *next;// 下一个链表元素的地址
};// 存储数组的链表
typedef struct {ngx_list_part_t  *last; // 指向链表的最后一个元素ngx_list_part_t   part; // 指向链表的第一个元素size_t            size; // 限制存储值的大小ngx_uint_t        nalloc; // 每个ngx_list_part_t数组的容量ngx_pool_t       *pool; // 链表中管理内存分配的内存池对象
} ngx_list_t;

图解如下：

ngx_table_elt_t【key/value】

typedef struct ngx_table_elt_s  ngx_table_elt_t;struct ngx_table_elt_s {ngx_uint_t        hash; // 用于快速检索头部ngx_str_t         key; // 名字ngx_str_t         value; // 值u_char           *lowcase_key; // key全是小写ngx_table_elt_t  *next; // 
};

用于存储HTTP头部

ngx_buf_t

typedef void *            ngx_buf_tag_t;typedef struct ngx_buf_s  ngx_buf_t;u_char          *pos;  // 从这个位置开始处理内存中的数据u_char          *last; // 表示有效的内容的结束位置off_t            file_pos;  //  要处理文件的位置off_t            file_last; //  要处理文件的截止位置u_char          *start;         /* start of buffer */  // 要处理内存的起始地址u_char          *end;           /* end of buffer */    // 要处理内存的末尾地址ngx_buf_tag_t    tag;  // 缓冲区的类型，例如由哪个模块使用就指向这个模块变量的地址ngx_file_t      *file;  // 引用的文件类型ngx_buf_t       *shadow;/* the buf's content could be changed */unsigned         temporary:1; // 临时内存标记位，为1时表示数据在内存中且这段内存可以修改/** the buf's content is in a memory cache or in a read only memory* and must not be changed*/unsigned         memory:1; // 标志位，为1时表示数据在内存中且这段内存不可以被修改/* the buf's content is mmap()ed and must not be changed */unsigned         mmap:1; // 标志位，为1时表示这段内存是用mmap系统调用映射过来的，不可以被修改unsigned         recycled:1; // 标志位， 为1表示可回收unsigned         in_file:1; // 标志位，为1表示这段缓冲区处理的是文件而不是内存unsigned         flush:1; // 标志位，为1时表示需要执行flush操作unsigned         sync:1; // 标志位，对操作这块缓冲区是否使用同步方式，unsigned         last_buf:1; // 标志位，表示是否是最后一块缓冲区，因为ngx_buf_t可以由ngx_chain_t链表串联起来unsigned         last_in_chain:1; // 标志位，表示是否是ngx_chain_t中的最后一块缓冲区unsigned         last_shadow:1; // 标志位，表示是否为最后一个影子缓冲区unsigned         temp_file:1; // 标志位，表示当前缓冲区是否属于临时文件/* STUB */ int   num;
};

缓冲区，处理大数据，既用于存储内存数据，也用于存储磁盘数据。

ngx_chain_t

typedef struct ngx_chain_s           ngx_chain_t;struct ngx_chain_s {ngx_buf_t    *buf; // 指向当前的ngx_buf_t缓冲区ngx_chain_t  *next; // 指向下一个ngx_chain_t，如果是最后一个，则为NULL
};

在向用户发送HTTP包体时，就要传入ngx_chain_t链表对象，注意，如果是最后一个ngx_chain_t，那么必须将next置为NULL，否则永远不会发送成功，而且这个请求将一直不会结束