ngx_hash.{c|h}实现了nginx里面比较重要的一个hash结构,这个在模块配置解析里经常被用到。该hash结构是只读的,仅在初始创建时可以给出保存在其中的key-val对儿,然后就只能进行“增删改查”操作了。
先来看一下hash结构的内存布局:
typedef struct {
ngx_hash_t *hash; //指向待初始化的散列结构
ngx_hash_key_pt key; //为计算散列值用的函数指针
ngx_uint_t max_size; //允许的最大bucket数量
ngx_uint_t bucket_size; //为每个bucket允许占用的最大空间
char *name; //初始化的散列名称(尽在错误日志中使用)
ngx_pool_t *pool; //用于分配散列结构空间的内存池
ngx_pool_t *temp_pool; //用于分配临时数据空间的内存池
} ngx_hash_init_t;
具体含义还要看图理解。这里不解析代码了,虽然看着繁琐,但是用起来还是相当方便。
一般操作有,创建hash和hash中进行查找。
创建hash:
1.构造一个 ngx_hash_key_t 为成员的数组, 包含 key, value和 使用key计算出的一个hash值
2.构建一个 ngx_hash_init_t结构体的变量, 其中包含了ngx_hash_t的成员, 为hash的结构体, 还包括一些其他初始设置,如bucket的大小,内存池等
3.调用 ngx_hash_init 传入ngx_hash_init_t 结构, ngx_hash_key_t 的数组,和数组的长度,进行初始化,这样 ngx_hash_init_t的hash成员就是我们要的hash结构
查找的过程很简单
1.计算 key 的hash值
2.使用 ngx_hash_find 进行查找,需要同时传入hash值和key ,返回的就是value的指针
需要注意的是,nginx 的 hash 在查找时使用的是分桶后线性查找法,因此当分桶数确定时查找效率同其中的总 key-val 对数量成反比