Struct ManagedCache 

pub struct ManagedCache { /* private fields */ }

A named, self-expiring, size-bounded cache (see the module doc).

Implementations

impl ManagedCache

pub fn create_cache(name: &str, expiry_ms: u64) -> Arc<ManagedCache>

Obtain (or create) the named cache with the default 2000-item bound (Java createCache(name, expiryMs)). Idempotent by name: a later call returns the existing instance unchanged — the first creation’s parameters win, later parameters are ignored (Java semantics).

pub fn create_cache_with_limit( name: &str, expiry_ms: u64, max_items: u64, ) -> Arc<ManagedCache>

Obtain (or create) the named cache (Java createCache(name, expiryMs, maxItems)). Expiry is clamped to [1 s, ~100 years].

pub fn get_instance(name: &str) -> Option<Arc<ManagedCache>>

Resolve a cache by name from any module (Java getInstance).

pub fn get_cache_collection() -> BTreeMap<String, Arc<ManagedCache>>

Sorted snapshot of every registered cache for ops introspection (Java getCacheCollection returns the live map — design §5).

pub fn put<V: Any + Send + Sync>(&self, key: &str, value: V)

Store a value (Java put) — stamps last_write; empty key = no-op. NEVER pass a pre-wrapped Arc/CacheValue here — it would nest (Arc<Arc<T>>) and get_as::<T> would miss; use Self::put_arc for values that are already reference-counted.

pub fn put_arc(&self, key: &str, value: CacheValue)

Store an already-wrapped value — stamps last_write; empty key = no-op.

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

Fetch a value (Java get) — stamps last_read on any non-empty-key call, hit or miss (Java stamps before the lookup).

pub fn get_as<T: Any + Send + Sync>(&self, key: &str) -> Option<Arc<T>>

Typed fetch: None on absence OR type mismatch — the Rust analog of the cast at a Java call site.

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

Java exists — delegates to get, so it inherits the last_read stamp.

pub fn remove(&self, key: &str)

Java remove — stamps last_write even when the key is absent.

pub fn clear(&self)

Java clear is three operations: stamp lastReset, invalidateAll(), cleanUp() — the cleanup keeps size() honest immediately after a clear. Emits no log (only clean_up logs).

pub fn clean_up(&self)

Java cleanUp — apply pending maintenance (expiry sweep, deferred evictions) now.

pub fn name(&self) -> &str

Cache name (Java getName).

pub fn expiry_ms(&self) -> u64

The clamped expiry in ms (Java getExpiry returns the clamped value).

pub fn max_items(&self) -> u64

Capacity bound (Java getMaxItems).

pub fn size(&self) -> u64

Estimated entry count (Java size() = Caffeine estimatedSize; moka entry_count — call Self::clean_up first for freshness).

pub fn entries(&self) -> Vec<(String, CacheValue)>

Snapshot of the unexpired entries (Java getMap returns a live ConcurrentMap view; Rust hands out no live guard — design §5).

pub fn last_read(&self) -> i64

Epoch ms of the last get/exists (Java getLastRead; 0 = never).

pub fn last_write(&self) -> i64

Epoch ms of the last put/remove (Java getLastWrite; 0 = never).

pub fn last_reset(&self) -> i64

Epoch ms of construction or the last clear (Java getLastReset).