cacheutil

Documentation

Index

• type LRUCache
  • func NewLRUCache(maxEntries int) *LRUCache
  • func (c *LRUCache) Add(key string, value interface{}) (cachedValue interface{}, done func(), added bool)
  • func (c *LRUCache) Get(key string) (value interface{}, done func(), ok bool)
  • func (c *LRUCache) Remove(key string)
• type TTLCache
  • func NewTTLCache(ttl time.Duration) *TTLCache
  • func (c *TTLCache) Add(key string, value interface{}) (cachedValue interface{}, done func(), added bool)
  • func (c *TTLCache) Get(key string) (value interface{}, done func(), ok bool)
  • func (c *TTLCache) Remove(key string)

Types

type LRUCache

type LRUCache struct {

	// OnEvicted optionally specifies a callback function to be
	// executed when an entry is purged from the cache.
	OnEvicted func(key string, value interface{})
	// contains filtered or unexported fields
}

LRUCache is "groupcache/lru"-like cache. The difference is that "groupcache/lru" immediately finalizes theevicted contents using OnEvicted callback but our version strictly tracks the reference counts of contents and calls OnEvicted when nobody refers to the evicted contents.

func NewLRUCache

func NewLRUCache(maxEntries int) *LRUCache

NewLRUCache creates new lru cache.

func (*LRUCache) Add

func (c *LRUCache) Add(key string, value interface{}) (cachedValue interface{}, done func(), added bool)

Add adds object to the cache and returns the cached contents with incrementing the reference count. If the specified content already exists in the cache, this sets `added` to false and returns "already cached" content (i.e. doesn't replace the content with the new one). Client must call `done` callback to decrease the counter when the value will no longer be used.

func (*LRUCache) Get

func (c *LRUCache) Get(key string) (value interface{}, done func(), ok bool)

Get retrieves the specified object from the cache and increments the reference counter of the target content. Client must call `done` callback to decrease the reference count when the value will no longer be used.

func (*LRUCache) Remove

func (c *LRUCache) Remove(key string)

Remove removes the specified contents from the cache. OnEvicted callback will be called when nobody refers to the removed content.

type TTLCache

type TTLCache struct {

	// OnEvicted optionally specifies a callback function to be
	// executed when an entry is purged from the cache.
	OnEvicted func(key string, value interface{})
	// contains filtered or unexported fields
}

TTLCache is a ttl-based cache with reference counters. Each elements is deleted as soon as expiering the configured ttl.

func NewTTLCache

func NewTTLCache(ttl time.Duration) *TTLCache

NewTTLCache creates a new ttl-based cache.

func (*TTLCache) Add

func (c *TTLCache) Add(key string, value interface{}) (cachedValue interface{}, done func(), added bool)

Add adds object to the cache and returns the cached contents with incrementing the reference count. If the specified content already exists in the cache, this sets `added` to false and returns "already cached" content (i.e. doesn't replace the content with the new one). Client must call `done` callback to decrease the counter when the value will no longer be used.

func (*TTLCache) Get

func (c *TTLCache) Get(key string) (value interface{}, done func(), ok bool)

Get retrieves the specified object from the cache and increments the reference counter of the target content. Client must call `done` callback to decrease the reference count when the value will no longer be used.

func (*TTLCache) Remove

func (c *TTLCache) Remove(key string)

Remove removes the specified contents from the cache. OnEvicted callback will be called when nobody refers to the removed content.