基本介绍

gcache是提供统一的缓存管理模块,提供了开发者可自定义灵活接入的缓存适配接口,并提供了高速内存缓存适配实现。

使用方式

  1. import "github.com/gogf/gf/os/gcache"

接口文档

https://godoc.org/github.com/gogf/gf/os/gcache

简要介绍:

  1. gcache默认提供默认的高速内存缓存对象,可以通过包方法操作内存缓存,也可以通过New方法创建内存缓存对象。在通过包方法使用缓存功能时,操作的是gcache默认提供的一个gcache.Cache对象,具有全局性,因此在使用时注意全局键名的覆盖。

  2. gcache使用的键名类型是interface{},而不是string类型,这意味着我们可以使用任意类型的变量作为键名,但大多数时候建议使用string或者[]byte作为键名,并且统一键名的数据类型,以便维护。

  3. gcache存储的键值类型是interface{},也就是说可以存储任意的数据类型,当获取数据时返回的也是interface{}类型,若需要转换为其他的类型可以通过gcacheGet*方法便捷获取常见类型。注意,如果您确定知道自己使用的是内存缓存,那么可以直接使用断言方式对返回的interface{}变量进行类型转换,否则建议使用GetVar方法后通过泛型的对应方法完成类型转换。

  4. 另外需要注意的是,gcache的缓存过期时间参数duration的类型为time.Duration类型,在Set缓存变量时,如果缓存时间参数duration = 0表示不过期,duration < 0表示立即过期,duration > 0表示超时过期。

Context上下文

gcache组件支持Context上下文变量的传递,通过链式操作方法实现。Context上下文特别对于第三方适配器实现的缓存能力很有必要,例如Redis缓存适配需要通过Context来传递链路跟踪信息。

方法定义:

  1. // Ctx is a chaining function, which shallowly clones current object and sets the context
  2. // for next operation.
  3. func Ctx(ctx context.Context) *Cache

使用示例:

  1. gcache.Ctx(ctx).Set("key", "value", 0)
  2. fmt.Println(gcache.Ctx(ctx).Get("key"))

Content Menu