https://github.com/bbdshow/gocache
一款简易的内存缓存实现，支持容量控制，TTL和数据落盘。
https://github.com/bbdshow/gocache
cache golang memory-cache ttl-cache
Last synced: about 2 months ago
JSON representation
一款简易的内存缓存实现，支持容量控制，TTL和数据落盘。
- Host: GitHub
- URL: https://github.com/bbdshow/gocache
- Owner: bbdshow
- License: mit
- Created: 2018-11-01T07:19:27.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-09-03T06:36:17.000Z (over 4 years ago)
- Last Synced: 2025-08-14T12:41:04.542Z (9 months ago)
- Topics: cache, golang, memory-cache, ttl-cache
- Language: Go
- Homepage:
- Size: 51.8 KB
- Stars: 6
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gocache
[](https://travis-ci.org/bbdshow/gocache)
[](https://codecov.io/gh/bbdshow/gocache)
[](https://goreportcard.com/report/github.com/bbdshow/gocache)
> 一款简易的内存缓存实现，支持容量控制，TTL和数据落盘。
## 特性
1. Store接口使用 sync.Map 和 读写锁+MAP 两种实现
2. 采用 sync.Map 实现， 在多核，大量读取，锁竞争多的情况下存在优势，缺点是内存占用高，空间换时间。
3. 支持容量限制，超过容量报错
3. 支持重启程序加载缓存内容，简单防止因重启导致的缓存击穿。
4. 支持 TTL Key
## 接口方法
```go
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倍，如果读读取要求不强烈。建议选择此实现方式。