KCache-go本地缓存，支持本地缓存过期、缓存过期自维护机制。

GitHub - kocor01/kcache: go 本地缓存解决方案，支持本地缓存过期、缓存过期自维护机制。

最近系统并发很高，单接口10W的 QPS，对 redis 压力很大，大量的热KEY导致 redis 分片CPU资源经常告警。计划用 go 本地缓存缓解 redis 的压力。

有多个系统需要使用本地缓存，写了 KCache 方便各个系统使用。

本地压测达到 100W QPS。

使用请参考 使用实例

创建KCache

• 创建一个KCache, 默认本地缓存过期时间 5s

  kc := New() 

• 创建一个KCache, 自定义本地缓存过期时间

  kc := NewWithExp(2 * time.Second) 

获取缓存

• GET 获取缓存，函数不带参数，本地缓存过期时间为创建 KCache 时设置的全局过期时间。

    kc := New()   d := kc.Get("myKey", GetData()) 

  GET 方法包含两个参数，第一个参数为缓存的key，第二个参数为获取缓存数据的函数。当缓存不存在时，会调用函数获取数据，并将数据缓存起来。 函数需符合 GetKcDatafunc 类型、返回值需符合 KcData 类型。

  type GetKcDatafunc func() KcData  type KcData struct {    interface{}    error } 

  示例：

  // 获取缓存数据 func GetData() GetKcDatafunc {   return func() KcData {     // sleep 模拟从 Redis、DB 中获取数据     time.Sleep(20 * time.Millisecond)      d := map[string]string{       "k1": "value1",       "k2": "value2",     }     return KcData{d: d, err: nil}   } } 

• Get 获取缓存，函数带参数

  kc := New() params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.Get("myKey", GetDataV2("myKey", params)) 

  示例：

  // 获取缓存数据 func GetDataV2(key string, params map[string]string) GetKcDatafunc {   return func() KcData {     // sleep 模拟从 Redis、DB 中获取数据，也可以先从 redis 获取数据, 如果获取不到，再从 DB 中获取。     time.Sleep(20 * time.Millisecond)      data := make(map[string]string)     for k, v := range params {       data[k+key] = v     }     return KcData{d: data, err: nil}   } } 

• GetWithExp 获取缓存，自定义本地缓存时间

  kc := New()  exp := 2 * time.Second params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.GetWithExp("myKey", exp, GetDataV2("myKey", params)) 

GetKcDatafunc 实现

• Kcache 中间函数（强烈推荐）

  通过 Kcache 中间函数调用原有的获取数据函数，该函数内部不含任何业务代码，减少业务代码与缓存代码的耦合。

  kc := New() exp := 2 * time.Second params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.GetWithExp("myKey", exp, GetDataKcache("myKey", params)) 

  // 获取缓存数据, Kcache 中间函数 func GetDataKcache(key string, params map[string]string) GetKcDatafunc {   return func() KcData {     data, err := GetDataV2(key, params)     return KcData{Data: data, Err: err}   } }  // 获取数据 func GetDataV2(key string, params map[string]string) (map[string]string, error) {   // sleep 模拟从 Redis、DB 中获取数据，也可以先从 redis 获取数据, 如果获取不到，再从 DB 中获取。   time.Sleep(20 * time.Millisecond)   data := make(map[string]string)     for k, v := range params {     data[k+key] = v   }   return data, nil } 

• 闭包函数（推荐）

  简单获取数据的业务逻辑可以使用闭包函数。

  kc := New() params := map[string]string{   "k1": "value1",   "k2": "value2", } key := "myKey" fc := func() KcData {   // sleep 模拟从 Redis、DB 中获取数据，也可以先从 redis 获取数据, 如果获取不到，再从 DB 中获取。   time.Sleep(20 * time.Millisecond)   data := make(map[string]string)   for k, v := range params {       data[k+key] = v   }   return KcData{Data: data, Err: nil} } d := kc.Get(key, fc) 

• 业务混合

  kc := New() d := kc.Get("myKey", GetData()) 

  // 获取缓存数据 func GetData() GetKcDatafunc {   return func() KcData {     // sleep 模拟从 Redis、DB 中获取数据     time.Sleep(20 * time.Millisecond)     d := map[string]string{       "k1": "value1",       "k2": "value2",     }     return KcData{Data: d, Err: nil}   } } 

设置缓存

• Set 设置缓存，本地缓存过期时间为创建 KCache 时设置的全局过期时间。

  正常情况下无需使用 Set 方法，因为 Get 方法会自动设置缓存。

  kc := New() params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.Set("myKey", params) 

• SetWithExp 设置缓存，自定义本地缓存时间。

  正常情况下无需使用 SetWithExp 方法，因为 Get 方法会自动设置缓存。

  kc := New() exp := 2 * time.Second params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.SetWithExp("myKey", params, exp) 

删除缓存

• Delete 删除本地缓存

  正常情况下无需使用 Delete 方法，因为有自动删除缓存机制。

  kc := New() params := map[string]string{   "k1": "value1",   "k2": "value2", } d := kc.Delete("myKey") 

单纯使用本地缓存

• 不需要自维护缓存数据

• 底层使用的 go-cache，go-cache下的所有方法都可以使用。

  kc := New() // SET kc.lc.Set("myKey", "myValue", 2*time.Second) // GET d, f := kc.lc.Get("myKey") // other ...  

更多使用案列请参考 使用实例