cache

Documentation

Index

• type Cache
  • func New(interval time.Duration) *Cache
  • func (c Cache) Get(key interface{}) interface{}
  • func (c Cache) GetWithExpire(key interface{}) (payload interface{}, expired time.Time)
  • func (c Cache) Put(key interface{}, payload interface{}, ttl time.Duration)
• type EvictCallback
• type LruCache
  • func NewLRUCache(options ...Option) *LruCache
  • func (c *LruCache) CloneTo(n *LruCache)
  • func (c *LruCache) Delete(key interface{})
  • func (c *LruCache) Exist(key interface{}) bool
  • func (c *LruCache) Get(key interface{}) (interface{}, bool)
  • func (c *LruCache) GetWithExpire(key interface{}) (interface{}, time.Time, bool)
  • func (c *LruCache) Set(key interface{}, value interface{})
  • func (c *LruCache) SetWithExpire(key interface{}, value interface{}, expires time.Time)
• type Option
  • func WithAge(maxAge int64) Option
  • func WithEvict(cb EvictCallback) Option
  • func WithSize(maxSize int) Option
  • func WithStale(stale bool) Option
  • func WithUpdateAgeOnGet() Option

Types

type Cache

type Cache struct {
	// contains filtered or unexported fields
}

Cache store element with a expired time

func New

func New(interval time.Duration) *Cache

New return *Cache

func (Cache) Get

func (c Cache) Get(key interface{}) interface{}

Get element in Cache, and drop when it expired

func (Cache) GetWithExpire

func (c Cache) GetWithExpire(key interface{}) (payload interface{}, expired time.Time)

GetWithExpire element in Cache with Expire Time

func (Cache) Put

func (c Cache) Put(key interface{}, payload interface{}, ttl time.Duration)

Put element in Cache with its ttl

type EvictCallback

type EvictCallback = func(key interface{}, value interface{})

EvictCallback is used to get a callback when a cache entry is evicted

type LruCache

type LruCache struct {
	// contains filtered or unexported fields
}

LruCache is a thread-safe, in-memory lru-cache that evicts the least recently used entries from memory when (if set) the entries are older than maxAge (in seconds). Use the New constructor to create one.

func NewLRUCache

func NewLRUCache(options ...Option) *LruCache

NewLRUCache creates an LruCache

func (*LruCache) CloneTo

func (c *LruCache) CloneTo(n *LruCache)

CloneTo clone and overwrite elements to another LruCache

func (*LruCache) Delete

func (c *LruCache) Delete(key interface{})

Delete removes the value associated with a key.

func (*LruCache) Exist

func (c *LruCache) Exist(key interface{}) bool

Exist returns if key exist in cache but not put item to the head of linked list

func (*LruCache) Get

func (c *LruCache) Get(key interface{}) (interface{}, bool)

Get returns the interface{} representation of a cached response and a bool set to true if the key was found.

func (*LruCache) GetWithExpire

func (c *LruCache) GetWithExpire(key interface{}) (interface{}, time.Time, bool)

GetWithExpire returns the interface{} representation of a cached response, a time.Time Give expected expires, and a bool set to true if the key was found. This method will NOT check the maxAge of element and will NOT update the expires.

func (*LruCache) Set

func (c *LruCache) Set(key interface{}, value interface{})

Set stores the interface{} representation of a response for a given key.

func (*LruCache) SetWithExpire

func (c *LruCache) SetWithExpire(key interface{}, value interface{}, expires time.Time)

SetWithExpire stores the interface{} representation of a response for a given key and given expires. The expires time will round to second.

type Option

type Option func(*LruCache)

Option is part of Functional Options Pattern

func WithAge

func WithAge(maxAge int64) Option

WithAge defined element max age (second)

func WithEvict

func WithEvict(cb EvictCallback) Option

WithEvict set the evict callback

func WithSize

func WithSize(maxSize int) Option

WithSize defined max length of LruCache

func WithStale

func WithStale(stale bool) Option

WithStale decide whether Stale return is enabled. If this feature is enabled, element will not get Evicted according to `WithAge`.

func WithUpdateAgeOnGet

func WithUpdateAgeOnGet() Option

WithUpdateAgeOnGet update expires when Get element