Struct ProxyCache 

pub struct ProxyCache {
    pub entries: Vec<CacheEntry>,
    pub max_size_bytes: u64,
    pub used_bytes: u64,
}

In-memory proxy cache with configurable capacity.

Fields

entries: Vec<CacheEntry>

All cached entries.

max_size_bytes: u64

Maximum allowed total size of the cache in bytes.

used_bytes: u64

Current total size of all entries in bytes.

Implementations

impl ProxyCache

pub fn new(max_size_bytes: u64) -> Self

Create a new, empty cache with the given maximum size.

pub fn add(&mut self, path: &str, size: u64, now_ms: u64)

Add a new entry to the cache.

If an entry with the same path already exists it is replaced and the used-byte count is updated accordingly.

pub fn touch(&mut self, path: &str, now_ms: u64) -> bool

Update the access timestamp and hit count for an entry.

Returns true if the entry was found and updated.

pub fn evict_lru(&mut self) -> Option<String>

Remove the least-recently-used entry and return its path.

Returns None if the cache is empty.

pub fn evict_stale(&mut self, now_ms: u64, ttl_ms: u64) -> Vec<String>

Remove all entries that are stale (last access older than ttl_ms).

Returns the paths of all evicted entries.

pub fn utilization(&self) -> f64

Cache utilisation as a fraction in [0.0, 1.0].

Returns 0.0 when max_size_bytes is 0.

Trait Implementations

impl Debug for ProxyCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.