memcache

go-memcache

In-memory cache with expiration and eviction

Описание

Потокобезопасный кэш данных в памяти.

Память дорогостоящий ресурс и поэтому кэш снабжен механизмом очистки устаревших записей, а также механизмом вытеснения записей при достижении лимита. Механизм очистки запускается при указании CleanupInterval, а вытеснения при указании LimitEnties. Вытеснение работает по принципу - сначала вытесняются устаревшие записи, а за тем в порядке стойкости.

Установка

go get github.com/a-projects/go-memcache@latest

Использование

import (
	"fmt"
	"time"

	"github.com/a-projects/go-memcache"
)

func main() {
	// создаём экземпляр кэша
	cache := memcache.New(memcache.MemcacheOptions{
		// выполнение очистки записей с периодичностью 15 минут
		CleanupInterval: time.Minute * 15,
		// лимит записей в кэше, после которого начинает работать вытеснение
		LimitEntries: 65_536,
		// файл для восстановления кэша при перезапуске приложения
		DataStore: "cache.bin"
	})

	// пробуем получить значение записи по ключу "foo"
	res, ok := cache.Get("foo")

	// если не удаётся получить значение записи
	// причины:
	//   - никто не добавлял запись с этим ключом
	//   - запись была добавлена, но устарела
	//   - запись была добавлена, но была очищена
	//   - запись была добавлена, но была вытеснена
	if !ok {
		// получаем значение из внешних источников
		res = "bar"

		// добавляем отсутствующую запись в кэш в виде ключ, значение
		cache.Set("foo", res, memcache.MemcacheEntryOptions{
			// время жизни записи
			Expiration: time.Now().Add(time.Minute * 5),
			// стойкость к вытеснению
			Durability: memcache.Normal,
		})
	}

	// приводим результат к нужному типу и выводим в консоль
	fmt.Printf(res.(string))

	// останавливаем экземпляр, чтобы данные кэша были сохранены в файл
	cache.Close()
}