bbdshow/gocache

一款简易的内存缓存实现，支持容量控制，TTL和数据落盘。

gocache

一款简易的内存缓存实现，支持容量控制，TTL和数据落盘。

特性

1. Store接口使用 sync.Map 和 读写锁+MAP 两种实现
2. 采用 sync.Map 实现， 在多核，大量读取，锁竞争多的情况下存在优势，缺点是内存占用高，空间换时间。
3. 支持容量限制，超过容量报错
4. 支持重启程序加载缓存内容，简单防止因重启导致的缓存击穿。
5. 支持 TTL Key

接口方法

package gocache

type Cache interface {
	Get(key string) (value interface{}, exists bool)                      //
	GetWithExpire(key string) (value interface{}, ttl int64, exists bool) // 返回值和剩余时间
	Set(key string, value interface{}) error                              //
	SetWithExpire(key string, value interface{}, ttl int64) error         // ttl 秒级别
	Keys(prefix string) Keys                                              // prefix - 前缀查询，"" 查询所有， 只返回当前有效的key
	Delete(key string)                                                    //
	Size() int64                                                          // 当前存储的数据量
	FlushAll()                                                            // 删除所有 key
	GobRegister(v ...interface{})                                         // 注册自定义结构体
	WriteToDisk() error                                                   // 写入数据到磁盘， 如果存在自定义结构类型，在使用时 一定要先注册结构
	LoadFromDisk() error                                                  // 从磁盘加载数据
	Close()                                                               //
}

type Keys interface {
	Size() int64
	Value() []string
}

type Store interface {
	Load(key string) (value interface{}, ok bool)
	Store(key string, value interface{})
	Delete(key string)
	LoadOrStore(key string, value interface{}) (actual interface{}, loaded bool)
	Exists(key string) bool
	Range(f func(k string, v interface{}) bool)
	Size() int64
	Flush()
}

Usage

go get github.com/bbdshow/gocache

请查看 example 目录

Notice

• 选择 sync.Map 的实现方式需要 golang 1.11^
• master 分支为开发分支，最新版本

FAQ

选择 sync.Map 实现

利用 sync.map 达到读取性能相对更高，sync.Map 并不太适应大量写入的缓存操作, 且因为计数使用了 LoadOrStrore 对 key 计数。 sync.Map 在内存空间上并不占优势，约 rwMutex + map 的2倍。

在 4 核以内的机器上锁竞争不明显， 所以 RwMutex map 在性能上更占优势，但是当 cpu 核数 往上时， 锁竞争变大， sync.Map 的优势就体现出来了。 性能测试 引用 https://medium.com/@deckarep/the-new-kid-in-town-gos-sync-map-de24a6bf7c2c

选择 rwMutex + map 实现

读写都比较均衡，同时内存占用比 sync.Map 约小1倍，如果读读取要求不强烈。建议选择此实现方式。