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
...

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