Struct StatsCache 

pub struct StatsCache<C> { /* private fields */ }

A cache wrapper that records hits and misses via CacheStats.

On each get call:

• If the inner cache returns Some(v) → hit recorded.
• If the inner cache returns None → miss recorded.

Type parameters

• C: inner Cache<Vec<u8>, Vec<u8>> implementation.

Implementations

impl<C> StatsCache<C>

where C: Cache<Vec<u8>, Vec<u8>>,

pub fn new(inner: C) -> Self

Wrap inner with a freshly created CacheStats.

pub fn with_stats(inner: C, stats: Arc<CacheStats>) -> Self

Wrap inner with a shared CacheStats (useful for sharing across wrappers).

pub fn stats(&self) -> &Arc<CacheStats>

Return a reference to the underlying stats.

Trait Implementations

impl<C> Cache<Vec<u8>, Vec<u8>> for StatsCache<C>

where C: Cache<Vec<u8>, Vec<u8>>,

fn get(&mut self, key: &Vec<u8>) -> Option<&Vec<u8>>

Look up key, returning a reference to the value if present.

fn put(&mut self, key: Vec<u8>, value: Vec<u8>) -> Option<Vec<u8>>

Insert or update key -> value without a TTL.

fn put_with_ttl( &mut self, key: Vec<u8>, value: Vec<u8>, ttl: Duration, ) -> Option<Vec<u8>>

Insert or update key -> value with a time-to-live.

fn len(&self) -> usize

Return the number of live entries currently in the cache.

fn cap(&self) -> usize

Return the maximum number of entries the cache can hold.

fn remove(&mut self, key: &Vec<u8>) -> Option<Vec<u8>>

Remove the entry associated with key, returning its value if present.

fn clear(&mut self)

Remove all entries from the cache.

fn peek(&self, key: &Vec<u8>) -> Option<&Vec<u8>>

Look up key without updating access metadata (no promotion).

fn contains_key(&self, key: &Vec<u8>) -> bool

Return true if key is present in the cache (without promotion).

fn resize(&mut self, new_cap: usize)

Dynamically resize the cache capacity.

fn is_empty(&self) -> bool

Return true if the cache holds no entries.

fn get_or_insert(&mut self, key: K, default: impl FnOnce() -> V) -> &V

where K: Clone,

Return &V for key, inserting default() if the key is absent.

fn values(&self) -> Vec<&V>

Return all live (non-expired) values currently stored in the cache.

fn warm(&mut self, iter: impl IntoIterator<Item = (K, V)>)

Pre-populate the cache with (key, value) pairs from an iterator.