Struct FlattenCache 

pub struct FlattenCache { /* private fields */ }

A bounded, thread-safe flatten cache. Most callers want the process-wide one behind flatten_cached; the type is public so a host can own a separate instance with its own bounds.

Implementations

impl FlattenCache

pub fn new(max_entries: usize, max_bytes: usize) -> Self

A cache holding at most max_entries flattens and max_bytes bytes.

pub fn get_or_flatten<F>( &self, key: FlattenKey, flatten: F, ) -> Result<Arc<Vec<u8>>, XfaError>

where F: FnOnce() -> Result<Vec<u8>, XfaError>,

Return the cached flatten for key, or run flatten and store its result. The closure runs without the lock held, so a slow flatten never blocks other lookups; two threads missing on the same key both flatten and the later store replaces the earlier one with identical bytes.

pub fn invalidate(&self, key: &FlattenKey) -> bool

Drop the entry for key, if any. Returns whether one was removed.

pub fn clear(&self)

Drop every entry. Counters are kept.

pub fn stats(&self) -> FlattenCacheStats

Current counters.