Struct GroupValueCache 

pub struct GroupValueCache { /* private fields */ }

Production-grade group value cache with TTL/LRU eviction.

Thread-safe — uses DashMap for concurrent access without global locking.

Implementations

impl GroupValueCache

pub fn new(config: GroupValueCacheConfig) -> Self

Create a new cache with the given configuration.

pub fn with_defaults() -> Self

Create a cache with default configuration.

pub fn is_enabled(&self) -> bool

Check if the cache is enabled.

pub fn config(&self) -> &GroupValueCacheConfig

Get the cache configuration.

pub fn get(&self, address: &GroupAddress) -> Option<Vec<u8>>

Get a cached value for a group address.

Returns None if:

• Cache is disabled
• Entry does not exist
• Entry has expired (TTL exceeded)

pub fn get_entry(&self, address: &GroupAddress) -> Option<CacheEntry>

Get a cached entry with full metadata.

Returns None if entry does not exist or has expired.

pub fn update( &self, address: GroupAddress, value: Vec<u8>, source: Option<String>, update_source: UpdateSource, )

Update the cache with a new value.

If the cache is at capacity, performs LRU eviction before inserting.

pub fn on_indication( &self, address: GroupAddress, value: Vec<u8>, source: Option<String>, )

Called when an L_Data.ind indication is received.

Updates the cache entry for the target group address if the cache is enabled and auto_update_on_indication is true.

pub fn on_write( &self, address: GroupAddress, value: Vec<u8>, source: Option<String>, )

Called when a GroupValueWrite is processed.

Updates the cache entry for the written group address.

pub fn invalidate(&self, address: &GroupAddress) -> bool

Invalidate (remove) a specific cache entry.

pub fn invalidate_all(&self)

Invalidate all cache entries.

pub fn purge_expired(&self) -> usize

Remove all expired entries.

Returns the number of entries removed.

pub fn len(&self) -> usize

Get the number of cached entries.

pub fn is_empty(&self) -> bool

Check if the cache is empty.

pub fn addresses(&self) -> Vec<GroupAddress>

Get all cached addresses.

pub fn stats_snapshot(&self) -> CacheStatsSnapshot

Get statistics snapshot.

pub fn entry_info(&self, address: &GroupAddress) -> Option<CacheEntryInfo>

Get a summary of cache state for a specific address.

pub fn all_entry_info(&self) -> Vec<CacheEntryInfo>

Get info for all entries.

Trait Implementations

impl Debug for GroupValueCache

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

Formats the value using the given formatter.

impl Default for GroupValueCache

fn default() -> Self

Returns the “default value” for a type.