go-cache的基本使用场景示例解析_Golang

go-cache的基本使用场景示例解析

2023-04-25 16:51LiP Golang

这篇文章主要为大家介绍了go-cache的基本使用场景示例解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪

什么是 go-cache

go-cache 是一个轻量级的基于内存的 K-V 储存组件，内部实现了一个线程安全的 map[string]interface{}，适用于单机应用。具备如下功能：

线程安全，多 goroutine 并发安全访问；
每个 item 可以设置过期时间（或无过期时间）；
自动定期清理过期的 item；
可以自定义清理回调函数；

这里的 item 指的是 map 里的元素。

go-cache 一般用作临时数据缓存来使用，而不是持久性的数据存储。对于某些停机后快速恢复的场景，go-cache支持将缓存数据保存到文件，恢复时从文件中将数据加载到内存。

使用

导入

				?

									github.com/patrickmn/go-cache

快速开始

				?

									c := cache.New(10*time.Second, 30*time.Second) 

									// 默认过期时间10s；清理间隔30s，即每30s会自动清理过期的键值对  

									// 设置一个键值对，过期时间是 3s 

									c.Set("a", "testa", 3*time.Second)  

									// 设置一个键值对，采用 New() 时的默认过期时间，即 10s 

									c.Set("foo", "bar", cache.DefaultExpiration)  

									// 设置一个键值对，没有过期时间，不会自动过期，需要手动调用 Delete() 才能删除 

									c.Set("baz", 42, cache.NoExpiration)  

									v, found := c.Get("a") 

									fmt.Println(v, found) // testa,true  

									<-time.After(5 * time.Second) // 延时5s 

									v, found = c.Get("a") // nil,false  

									fmt.Println(v, found)  

									<-time.After(6 * time.Second) 

									v, found = c.Get("foo") // nil,false  

									fmt.Println(v, found) 

									v, found = c.Get("baz") // 42,true  

									fmt.Println(v, found)

常量与结构体

常量

				?

									const (

									    NoExpiration time.Duration = -1    // 无有效时间

									    DefaultExpiration time.Duration = 0   // 表示采用默认时间

									)

这两个参数可以用作 New() 函数的第一个入参，则默认过期时间小于0，意味着添加键值对时如果采用默认过期时间，则该键值对不会过期，因为 DeleteExpired() 方法会判断 v.Expiration 是否大于 0，大于 0 时才会自动删除。如果想删除需要手动 Delete() 方法。

添加键值对，比如执行 Set()、Add() 等操作时，这两个常量也可以作为参数，NoExpiration 表示没有过期时间，DefaultExpiration 表示采用默认的过期时间。

结构体

主要的结构体包括下面这些：

				?

									type Item struct {  // 键值对

									 Object     interface{}     // 存放 K-V 的值，可以存放任何类型的值

									 Expiration int64   // 键值对的过期时间(绝对时间)

									}

									type Cache struct {   // 对外使用的 Cache

									 *cache  // cache 实例

									}

									type cache struct {

									 defaultExpiration time.Duration   // 默认的过期时间，添加一个键值对时如果设置默认的过期时间（即代码里的 DefaultExpiration）则会使用到该值

									 items             map[string]Item   // 存放的键值对

									 mu                sync.RWMutex   // 读写锁

									 onEvicted         func(string, interface{})  // 删除key时的回调函数

									 janitor           *janitor  // 定期清理器 定期检查过期的 Item

									}

									type janitor struct { // 清理器结构体

									 Interval time.Duration // 清理时间间隔

									 stop     chan bool     // 是否停止

									}