Skip to main content

内存缓存使用

概述

本章节主要介绍 cache 的使用。

准备条件

  1. 完成 golang 安装

创建

  1. NewCache
函数签名: 
NewCache func(expire time.Duration, opts ...CacheOption) (*Cache, error)
说明:
创建 cache 对象。
入参:
1. expire: 过期时间
2. opts: 操作选项
2.1 WithLimit: 设置 cache 存储数据数量上限
2.2 WithName: 设置 cache 名称,输出日志时会打印
返回值:
1. *Cache: cache对象
2. error: 创建结果

方法说明

  1. Set
函数签名: 
Set func(key string, value interface{})
说明:
添加值到缓存。
入参:
1. key: key
2. value: 值

示例:
cache, err := NewCache(time.Second*2, WithName("any"))
if err != nil {
log.Fatal(err)
}
cache.Set("first", "first element")
  1. SetWithExpire
函数签名: 
SetWithExpire func(key string, value interface{}, expire time.Duration)
说明:
添加值到缓存, 同时指定过期时间
入参:
1. key: key
2. value: 值
3. expire: 过期时间

示例:
cache, err := NewCache(time.Second*2, WithName("any"))
if err != nil {
log.Fatal(err)
}
cache.SetWithExpire("first", "first element", time.Second)
  1. Get
函数签名: 
Get func(key string) (interface{}, bool)
说明:
查询缓存
入参:
1. key: key

返回值:
1. interface{}: value
2. bool: 是否存在

示例:
cache, err := NewCache(time.Second*2, WithName("any"))
if err != nil {
log.Fatal(err)
}
cache.Set("first", "first element")

v, exist := cache.Get("first")
if !exist {
// deal with not exist
}
value, ok := v.(string)
if !ok {
// deal with type error
}
// use value
  1. Del
函数签名: 
Del func(key string)
说明:
删除缓存。
入参:
1. key: key

示例:
cache, err := NewCache(time.Second*2, WithName("any"))
if err != nil {
log.Fatal(err)
}
cache.Del("first")
  1. Take
函数签名: 
Take funcTake(key string, fetch func() (interface{}, error)) (interface{}, error)
说明:
获取缓存,如果缓存中存在,则返回缓存中的值,如果缓存不存在,则执行 fetch 函数的返回结果。
入参:
1. key: key
2. fetch: 自定义返回结果

示例:
cache, err := NewCache(time.Second*2, WithName("any"))
if err != nil {
log.Fatal(err)
}

v, err := cache.Take("first", func() (interface{}, error) {
return "first element", nil
})
println(v) // output: first element

cache.Set("first", "first element 2")

v, err = cache.Take("first", func() (interface{}, error) {
return "first element", nil
})
println(v) // // output: first element 2