Struct DefaultCache 

pub struct DefaultCache<K: CacheKey, V: CacheValue> { /* private fields */ }

In-memory Cache with an LRU eviction policy, byte-based memory limit, and optional per-entry TTL.

Entries are evicted in least-recently-used order whenever an insert would push memory_used above memory_limit. Inserts whose own size exceeds the limit are rejected (and any prior entry under the same key is removed). When a TTL is configured, the expiration is stamped onto each entry at insertion time and checked lazily on access. Entries with size 0 are rejected.

Implementations

impl<K: CacheKey, V: CacheValue> DefaultCache<K, V>

pub fn new(memory_limit: usize) -> Self

Create a cache with the given memory budget in bytes and no TTL.

pub fn new_with_ttl(memory_limit: usize, ttl: Option<Duration>) -> Self

Create a cache with the given memory budget in bytes and an optional TTL applied to every newly inserted entry.

pub fn with_name(self, name: impl Into<String>) -> Self

Override the cache name.

pub fn with_time_provider(self, provider: Arc<dyn TimeProvider>) -> Self

Override the time source used to stamp and check TTLs.

pub fn memory_used(&self) -> usize

Number of bytes currently accounted for by live entries.

Trait Implementations

impl<K: CacheKey, V: CacheValue> Cache<K, V> for DefaultCache<K, V>

fn get(&self, key: &K) -> Option<V>

Get a cached entry if it exists.

fn put(&self, key: &K, value: V) -> Option<V>

Store a value in the cache.

fn remove(&self, k: &K) -> Option<V>

Remove an entry from the cache, returning the value if it existed.

fn contains_key(&self, k: &K) -> bool

Check if the cache contains a specific key.

fn len(&self) -> usize

Fetch the total number of cache entries.

fn clear(&self)

Remove all entries from the cache.

fn name(&self) -> String

Return the cache name.

fn cache_limit(&self) -> usize

Current memory budget, in bytes.

fn update_cache_limit(&self, limit: usize)

Change the memory budget in bytes.

fn cache_ttl(&self) -> Option<Duration>

Time-to-live applied to newly inserted entries, or None if entries never expire on their own.

fn update_cache_ttl(&self, ttl: Option<Duration>)

Change the TTL applied to subsequent inserts.

fn drop_table_entries(&self, table_ref: &TableReference) -> Result<()>

Invalidate every entry associated with table_ref.

fn list_entries(&self) -> HashMap<K, CacheEntryInfo<V>>

Snapshot of all current entries with per-entry metadata (size, hits, expiration) for diagnostics and observability.

fn is_empty(&self) -> bool

Check if the cache collection is empty.