cache

func Del ¶

func Del(ctx context.Context, key string) error

Del 删除缓存。 删除指定 key 的缓存值。

func Get ¶

func Get(ctx context.Context, key string) (string, error)

Get 读取缓存。 根据 key 获取缓存值，若 key 不存在返回 ErrCacheMiss。

func GetService ¶

func GetService(ctx context.Context) (datacontract.Cache, error)

GetService 从容器获取统一缓存服务。 通过 ctx 解析框架容器后再解析缓存实例。

func MGet ¶

func MGet(ctx context.Context, keys ...string) (map[string]string, error)

MGet 批量读取缓存。 一次性获取多个 key 的值，返回 key→value 映射。

func MustGetService ¶ added in v0.1.4

func MustGetService(ctx context.Context) datacontract.Cache

MustGetService 从容器获取统一缓存服务，失败时 panic。 用于业务初始化阶段，确认缓存服务必须可用的场景。

func Remember ¶

func Remember(ctx context.Context, key string, ttl time.Duration, fn func(context.Context) (string, error)) (string, error)

Remember 读取缓存，未命中时回源计算并回填。 先尝试读取 key 的缓存值；若缓存未命中，则调用 fn 计算结果， 将结果写入缓存（ttl 过期时间）并返回。

Example:

value, err := cache.Remember(ctx, "user:42", time.Minute, func(ctx context.Context) (string, error) {
    return loadUserJSON(ctx, 42)
})

func Set ¶

func Set(ctx context.Context, key, value string, ttl time.Duration) error

Set 写入缓存。 将 value 写入 key，并设置过期时间 ttl。