Struct ContentAwareCache 

pub struct ContentAwareCache { /* private fields */ }

A media-content-aware cache that scores eviction candidates by a recency × priority × size metric rather than pure LRU order.

Internally, it delegates storage to an LruCache<String, CacheEntry> for O(1) operations and maintains a live count of bytes.

Implementations

impl ContentAwareCache

pub fn new(capacity: usize) -> Self

Create a new ContentAwareCache with an entry-count capacity.

pub fn with_max_bytes(self, max_bytes: usize) -> Self

Set an optional byte-level capacity in addition to the entry count cap.

pub fn with_scoring_weights(self, weights: ScoringWeights) -> Self

Set custom scoring weights used for eviction candidate selection.

pub fn set_scoring_weights(&mut self, weights: ScoringWeights)

Update scoring weights at runtime.

pub fn scoring_weights(&self) -> &ScoringWeights

Return a reference to the current scoring weights.

pub fn insert_media( &mut self, key: String, data: Vec<u8>, content_type: MediaContentType, )

Insert a media entry.

If the cache is at capacity, the entry with the highest eviction score is removed first. If the new entry has a higher priority than the current worst entry, it displaces it; otherwise the LRU entry is used as the fallback.

pub fn get(&mut self, key: &str) -> Option<&CacheEntry>

Look up key and return an immutable reference to its CacheEntry if present (updating last-accessed time).

pub fn peek(&self, key: &str) -> Option<&CacheEntry>

Peek at key without updating access metadata or LRU order.

pub fn remove(&mut self, key: &str) -> bool

Explicitly remove an entry by key.

Returns true if the entry was present.

pub fn evict_expired(&mut self) -> usize

Scan all entries and remove those whose TTL has elapsed.

Returns the number of entries evicted.

This is an O(n) operation; callers should invoke it periodically rather than on every access.

pub fn len(&self) -> usize

Return the number of entries currently in the cache.

pub fn is_empty(&self) -> bool

Return true when the cache has no entries.

pub fn total_bytes(&self) -> usize

Return the total number of bytes currently stored.

pub fn capacity(&self) -> usize

Return the entry-count capacity.