gojsj2025/backend/docs/gozero/ncache.md

内存缓存使用 概述 ​ 本章节主要介绍 cache 的使用。

准备条件 ​ 完成 golang 安装 创建 ​ 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: 创建结果 方法说明 ​ 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") 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) 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

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") 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