iOS标准库中经常使用数据结构和算法之cache

上一篇：iOS标准库中经常使用数据结构和算法以内存池

📝缓存Cache

缓存是以键值对的形式进行数据的存储和检索，内部采用哈希表实现。当系统出现内存压力时则会释放掉部分缓存的键值对。 iOS系统提供了一套基于OC语言的高级缓存库NSCache，同时也提供一套基于C语言实现的缓存库libcache.dylib，其中NSCache是基于libcache.dylib实现的高级类库，而且这两个库都是线程安全的。 本文主要介绍基于C语言的缓存库的各类API函数。

头文件： #include <cache.h>, #include <cache_callbacks.h> 平台： iOS系统

1、缓存对象的建立和关闭

功能：建立或者销毁一个缓存对象。 函数签名：

int cache_create(const char *name, cache_attributes_t *attrs, cache_t **cache_out);
int cache_destroy(cache_t *cache);
复制代码

参数： name:[in] 建立缓存时用来指定缓存的字符串名称，不能为空。 attrs: [in] 设置缓存的属性。不能为空。 cache_out: [out] 返回建立的缓存对象。 return: [out] 成功操做返回0，不然返回非0 描述: 缓存对象是一个容器对象，其缓存的内容是一个个键值对，至于这些键值对是什么类型的数据，如何控制键值对的数据的生命周期，如何判断两个键是不是相同的键等等这些信息缓存对象自己是没法得知，所以须要咱们明确的告诉缓存对象如何去操做这些键值信息。这也就是为何在建立缓存对象时须要指定属性这个参数了。属性的参数类型是一个cache_attributes_t结构体。这个结构体的大部分数据成员都是函数指针，这些函数指针就是用来实现对键值进行操做的各类策略。

struct cache_attributes_s {
    uint32_t version;  //缓存对象的版本信息
    cache_key_hash_cb_t key_hash_cb;  //对键执行hash计算的函数，不能为空                         
    cache_key_is_equal_cb_t key_is_equal_cb;  //判断两个键是否相等的函数，不能为空                      
    
    cache_key_retain_cb_t  key_retain_cb;   //键加入缓存时调用，用于增长键的引用计数或者进行内存拷贝。
    cache_release_cb_t key_release_cb;  //键的释放处理函数，用于对键的内存管理使用。
    cache_release_cb_t value_release_cb;  //值的释放处理函数，用于对值的内存管理使用。                         
    
    cache_value_make_nonpurgeable_cb_t value_make_nonpurgeable_cb;   //当值的引用计数从0变为1时对值内存进行非purgeable的处理函数。
    cache_value_make_purgeable_cb_t value_make_purgeable_cb;  //当值的引用计数变为0时对值进行purgeable的处理函数。这个函数的做用是为了解决当内存吃紧时自动释放所分配的内存。    
    
    void *user_data;  //附加数据，这个附加数据会在全部的这些回调函数中出现。

	// Added in CACHE_ATTRIBUTES_VERSION_2
	cache_value_retain_cb_t value_retain_cb;   //值增长引用计数的函数，用于对值的内存管理使用。
};
typedef struct cache_attributes_s cache_attributes_t;

复制代码

上述的各类回调函数的格式都在cache.h中有明确的定义，所以这里就再也不展开介绍了。通常状况下咱们一般都会将字符串或者整数来做为键使用，所以当你采用字符串或者整数做为键时，系统预置了一系列缓存对象属性的默认实现函数。这些函数的声明在cache_callbacks.h文件中

/*
 * Pre-defined callback functions.
 */

//用于键进行哈希计算的预置函数
CACHE_PUBLIC_API uintptr_t cache_key_hash_cb_cstring(void *key, void *unused);
CACHE_PUBLIC_API uintptr_t cache_key_hash_cb_integer(void *key, void *unused);
//用于键进行相等比较的预置函数
CACHE_PUBLIC_API bool cache_key_is_equal_cb_cstring(void *key1, void *key2, void *unused);
CACHE_PUBLIC_API bool cache_key_is_equal_cb_integer(void *key1, void *key2, void *unused);

//键值进行释放的函数，这函数默认实现就是调用free函数，所以若是采用这个函数进行释放处理则键值须要从堆中进行内存分配。
CACHE_PUBLIC_API void cache_release_cb_free(void *key_or_value, void *unused);

 //对值进行purgeable处理的预置函数。
CACHE_PUBLIC_API void cache_value_make_purgeable_cb(void *value, void *unused);
CACHE_PUBLIC_API bool cache_value_make_nonpurgeable_cb(void *value, void *unused);

复制代码

示例代码：

//下面代码用于建立一个以字符串为键的缓存对象，其中的缓存对象的属性中的各个成员函数采用的是系统默认预约的函数。
 #include <cache.h>
 #include <cache_callbcaks.h>

 cache_t *im_cache;
 cache_attributes_t attrs = {
         .version = CACHE_ATTRIBUTES_VERSION_2,
         .key_hash_cb = cache_key_hash_cb_cstring,
         .key_is_equal_cb = cache_key_is_equal_cb_cstring,
         .key_retain_cb = my_copy_string,
         .key_release_cb = cache_release_cb_free,
         .value_release_cb = cache_release_cb_free,
  };
  cache_create("com.acme.im_cache", &attrs, &im_cache);
复制代码

2、缓存对象中键值对的设置和获取以及删除

功能：用于处理键值对在缓存中的添加、获取和删除操做。 函数签名:

//将键值对添加到缓存，或者替换掉原有的键值对。
 int cache_set_and_retain(cache_t *cache, void *key, void *value, size_t cost);

//从缓存中根据键获取值
int cache_get_and_retain(cache_t *cache, void *key, void **value_out);

//将缓存中的值引用计数减1，当引用计数为0时则清理值分配的内存或者销毁值分配的内存。
int cache_release_value(cache_t *cache, void *value);

//从缓存中删除键值。
int cache_remove(cache_t *cache, void *key);

复制代码

参数： cache:[in] 缓存对象。 key:[in] 添加或者获取或者删除时的键。 cost:[in] 添加缓存时的成本代价，值越大键值在缓存中保留的时间就越长久。 value:[in] 添加时的值。 value_out: [out] 用于值获取时的输出。

描述：

1. cache_set_and_retain 函数用于将键值对放入缓存中，并指定cost值。当将一个键添加到缓存时，系统内部分别会调用缓存属性cache_attributes_t结构体中的key_retain_cb来实现对键的内存的管理，若是这个函数设置为NULL的话那就代表咱们须要本身负责键的生命周期的管理。由于缓存对象内部是经过哈希表来进行数据的存储和检索的，因此在将键值对加入缓存时，还须要提供对键进哈希计算和比较的属性函数key_hash_cb，key_is_equal_cb。 而对于值来讲，当值加入缓存时系统会将值的引用计数设置为1，若是咱们想自行处理值在缓存中的内存保存则须要指定缓存属性中的value_retain_cb来实现。加入缓存中的值是能够为NULL的。最后的cost参数用于指定这个键值对的成本值，值越小在缓存中保留的时间就越少，反之亦然。

2. cache_get_and_retain函数用来根据键获取对应的值，若是缓存中没有保存对应的键值对，或者键值对被丢弃，或者值所分配的内存被清除则value_out返回NULL，而且函数返回特殊的值ENOENT。每调用一次值的获取，缓存对象都会增长值的引用计数。所以当咱们再也不须要访问返回的值时则须要调用手动调用cache_release_value函数来减小缓存对象中值的引用计数。而当值的引用计数变为0时则值分配的内存会设置为可清理(purgeable)或者被销毁掉。

3. cache_remove函数用于删除缓存中的键值对。当删除缓存中的键值对时，缓存对象会调用属性结构体中的key_release_cb函数进行键的内存销毁，以及若是值的引用计数变为0时则会调用value_release_cb函数进行值的内存销毁。

示例代码:

#include <cache.h>
#include <cache_callbacks.h>

void main()
{
    cache_attributes_t attr;
    attr.key_hash_cb = cache_key_hash_cb_cstring;
    attr.key_is_equal_cb = cache_key_is_equal_cb_cstring;
    attr.key_retain_cb =  NULL;
    attr.key_release_cb = cache_release_cb_free;
    attr.version = CACHE_ATTRIBUTES_VERSION_2;
    attr.user_data = NULL;
    attr.value_retain_cb = NULL;
    attr.value_release_cb = cache_release_cb_free;
    attr.value_make_purgeable_cb = cache_value_make_purgeable_cb;
    attr.value_make_nonpurgeable_cb = cache_value_make_nonpurgeable_cb;
    
    //建立缓存
    cache_t *cache = NULL;
    int ret = cache_create("com.test", &attr, &cache);
    
    //将键值对放入缓存
    char *key = malloc(4);
    strcpy(key, "key");
    char *val = malloc(4);
    strcpy(val, "val");
    ret = cache_set_and_retain(cache, key, val, 0);
    ret = cache_release_value(cache, val);
    //获取键值对，使用后要释放。
    char *val2 = NULL;
    ret = cache_get_and_retain(cache, key, (void**)&val2);
    ret = cache_release_value(cache, val2);
    
    //删除键值
    cache_remove(cache, key);
    
    //销毁缓存。
    cache_destroy(cache);
}
复制代码

3、缓存中键值对的清理策略和值的访问策略

缓存的做用是会对保存在里面的键值对进行丢弃，这取决于当前内存的使用状况以及其余一些场景。在调用cache_set_and_retain将键值对添加到缓存时还会指定一个cost值，值越大被丢弃的可能性就越低。在上面的介绍中有说明缓存会对键值对中的值进行引用计数管理。当调用cache_set_and_retain时值引用计数将设置为1，调用cache_get_and_retain函数获取值时若是键值对在缓存中则会增长值的引用计数。而不须要访问和操做值时咱们须要调用cache_release_value函数来将引用计数减1。当值的引用计数变为0时就会当即或者之后发生以下的事情：

1. 若是咱们在缓存的属性结构体中设置了value_make_purgeable_cb函数则会调用这个函数代表此时值是能够被清理的。被清理的意思是说为值分配的物理内存随时有可能会被回收。所以当值被设置为可被清理状态时就不能继续去直接访问值所分配的内存了。
2. 若是在此以前键值对由于函数cache_remove的调用而被从缓存中删除，则会调用属性结构体中的value_release_cb函数来执行值内存的销毁处理。
3. 若是由于系统内存的压力致使须要丢弃缓存中的键值对时，就会把值引用计数为0的键值对丢弃掉！注意：只有值引用计数为0时才会缓存被丢弃。

每次对缓存中的值的访问都须要经过cache_get_and_retain函数来执行，当调用cache_get_and_retain函数时会发生以下事情：

1. 判断当前键值对是否在缓存中，若是再也不则值返回NULL。
2. 若是键值对在缓存中。而且值的引用计数为0，就会判断缓存的结构体属性中是否存在value_make_nonpurgeable_cb函数，若是存在则会调用value_make_nonpurgeable_cb函数将值的内存设置为不可清理，若是设置为不可清理返回为false则代表此时值的内存已经被清理了，这时候键值对将会从缓存中丢弃，而且cache_get_and_retain函数将返回值为NULL。固然若是value_make_nonpurgeable_cb函数为空则不会发生这一步。
3. 增长值的引用计数，并返回值。

---

欢迎你们访问欧阳大哥2013的github地址和简书地址