cache

cache

import "github.com/agentstation/starmap/internal/server/cache"

Package cache provides an in-memory caching layer for the HTTP server. It uses patrickmn/go-cache for TTL-based caching with LRU-like eviction.

Index

• type Cache
  • func New(defaultTTL, cleanupInterval time.Duration) *Cache
  • func (c *Cache) ActivateGeneration(sequence uint64, generationID string)
  • func (c *Cache) Clear()
  • func (c *Cache) Delete(key string)
  • func (c *Cache) GenerationID() string
  • func (c *Cache) Get(key string) (any, bool)
  • func (c *Cache) GetGeneration(sequence uint64, generationID, key string) (any, bool)
  • func (c *Cache) GetStats() Stats
  • func (c *Cache) ItemCount() int
  • func (c *Cache) Set(key string, value any)
  • func (c *Cache) SetGeneration(sequence uint64, generationID, key string, value any)
  • func (c *Cache) SetWithTTL(key string, value any, ttl time.Duration)
• type Stats

type Cache

Cache wraps go-cache with additional features for HTTP caching.

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

func New

func New(defaultTTL, cleanupInterval time.Duration) *Cache

New creates a new cache with the given TTL and cleanup interval. defaultTTL is the default expiration time for cache entries. cleanupInterval is how often expired items are removed from memory.

func (*Cache) ActivateGeneration

func (c *Cache) ActivateGeneration(sequence uint64, generationID string)

ActivateGeneration atomically changes the visible namespace and removes old entries. Repeating the same generation is a no-op.

func (*Cache) Clear

func (c *Cache) Clear()

Clear removes all items from the cache.

func (*Cache) Delete

func (c *Cache) Delete(key string)

Delete removes a value from the cache.

func (*Cache) GenerationID

func (c *Cache) GenerationID() string

GenerationID returns the active cache namespace.

func (*Cache) Get

func (c *Cache) Get(key string) (any, bool)

Get retrieves a value from the cache.

func (*Cache) GetGeneration

func (c *Cache) GetGeneration(sequence uint64, generationID, key string) (any, bool)

GetGeneration retrieves a key only from generationID. The first request may initialize an empty cache, but an in-flight old request cannot reactivate a superseded namespace.

func (*Cache) GetStats

func (c *Cache) GetStats() Stats

GetStats returns current cache statistics.

func (*Cache) ItemCount

func (c *Cache) ItemCount() int

ItemCount returns the number of items in the cache.

func (*Cache) Set

func (c *Cache) Set(key string, value any)

Set stores a value in the cache with default TTL.

func (*Cache) SetGeneration

func (c *Cache) SetGeneration(sequence uint64, generationID, key string, value any)

SetGeneration stores a key in the active generation namespace.

func (*Cache) SetWithTTL

func (c *Cache) SetWithTTL(key string, value any, ttl time.Duration)

SetWithTTL stores a value in the cache with custom TTL.

type Stats

Stats returns cache statistics.

type Stats struct {
    ItemCount    int    `json:"item_count"`
    GenerationID string `json:"generation_id,omitempty"`
    Sequence     uint64 `json:"sequence"`
}

Generated by gomarkdoc