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   // 表示采用默认时间
)

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     // 是否停止
}