基本介绍
gcache
是提供统一的缓存管理模块,提供了开发者可自定义灵活接入的缓存适配接口,并提供了高速内存缓存适配实现。
使用方式:
import "github.com/gogf/gf/os/gcache"
接口文档:
https://godoc.org/github.com/gogf/gf/os/gcache
简要介绍:
-
gcache
默认提供默认的高速内存缓存对象,可以通过包方法操作内存缓存,也可以通过New
方法创建内存缓存对象。在通过包方法使用缓存功能时,操作的是gcache
默认提供的一个gcache.Cache
对象,具有全局性,因此在使用时注意全局键名的覆盖。 -
gcache
使用的键名类型是interface{}
,而不是string
类型,这意味着我们可以使用任意类型的变量作为键名,但大多数时候建议使用string
或者[]byte
作为键名,并且统一键名的数据类型,以便维护。 -
gcache
存储的键值类型是interface{}
,也就是说可以存储任意的数据类型,当获取数据时返回的也是interface{}
类型,若需要转换为其他的类型可以通过gcache
的Get*
方法便捷获取常见类型。注意,如果您确定知道自己使用的是内存缓存,那么可以直接使用断言方式对返回的interface{}
变量进行类型转换,否则建议使用GetVar
方法后通过泛型的对应方法完成类型转换。 -
另外需要注意的是,
gcache
的缓存过期时间参数duration
的类 型为time.Duration
类型,在Set
缓存变量时,如果缓存时间参数duration = 0
表示不过期,duration < 0
表示立即过期,duration > 0
表示超时过期。
Context
上下文
gcache
组件支持 Context
上下文变量的传递,通过链式操作方法实现。 Context
上下文特别对于第三方适配器实现的缓存能力很有必要,例如 Redis
缓存适配需要通过 Context
来传递链路跟踪信息。
方法定义:
// Ctx is a chaining function, which shallowly clones current object and sets the context
// for next operation.
func Ctx(ctx context.Context) *Cache
使用示例:
gcache.Ctx(ctx).Set("key", "value", 0)
fmt.Println(gcache.Ctx(ctx).Get("key"))