GCache

---

gcache is a lightweight local caching solution that enables concurrent access and retrieval of key-value data.

• Concurrency: In a test environment on macOS with 10 cores and a memory limit of 2GB, gcache can concurrently store up to 40,000 data per second and retrieve up to 60,000 data per second.

• Support for eviction policies: gcache allows you to specify the maximum percentage of data and space that can be released by a single cache server. When the trigger condition is met, gcache uses the Least Recently Used (LRU) algorithm to eliminate the maximum data percentage.

• Manager mutil cache nodes by consistent hash.

• Expiration policy support: Similar to Redis, gcache lets you set an expiration time for cached data.

• Generic key structure: The key data type can be specified based on your requirements. Currently, int, int64, float64, and string are supported.

• Value data uses any(equal with interface), which means that data needs to be forcefully converted when transferred.

WARN:Data persistence is not supported

WARN: Every time the max value is reset, if it is larger than the previous value, it will cause the corresponding node's cache data to be reallocated

---

USE

go get github.com/NoahAmethyst/gcache

You can watch code in ./gotest see how to use Or see function below:

Init Cache

import "github.com/NoahAmethyst/gcache"
//New Cache with max data size and percentage of free up size
//It support Generic Key type
//You should specify concrete type you need for the key type
max := 20000
localCache := gcache.NewCache[string](max, 10)

Put data into cache

import "github.com/NoahAmethyst/gcache"

max := 20000
localCache := gcache.NewCache[string](max, 10)


//Put data into cache and set expire time
k:="test"
v:="test_data"
localCache.Put(k, v, 10*time.Millisecond)

//Put data into cache without expire
//Option1
k="test_2"
v="test_data_2"
localCache.Put(k, v)

//Put data into cache without expire
//Option2
k="test_2"
v="test_data_2"
localCache.Put(k, v, gcache.NotExpire)

Get data from cache

import "github.com/NoahAmethyst/gcache"

max := 20000
localCache := gcache.NewCache[string](max, 10)


//Get data from cache
//ok is false when data(key) not exist or expired
k:= "test"
v, ok := localCache.Get(k)

Get data expire time

import "github.com/NoahAmethyst/gcache"

max := 20000
localCache := gcache.NewCache[string](max, 10)


//Get data expire time
//ok is false when data(key) not exist
k:= "test"
expireAt, ok := localCache.ExpireAt(k)

Get all keys

import "github.com/NoahAmethyst/gcache"

max := 20000
localCache := gcache.NewCache[string](max, 10)

//Get all keys
//return a slice with exist and not expired keys
keys := localCache.Keys()