Struct Cache 

pub struct Cache<K, V>
where
    K: Eq + Hash + Clone,
{ /* private fields */ }

LRU 缓存

Implementations

impl<K, V> Cache<K, V>

where K: Eq + Hash + Clone,

pub fn new(config: CacheConfig) -> Self

创建新缓存

pub fn with_defaults() -> Self

使用默认配置创建

pub fn insert(&self, key: K, value: V)

插入条目

pub fn insert_with_ttl(&self, key: K, value: V, ttl: Option<Duration>)

插入条目（自定义 TTL）

pub fn get(&self, key: &K) -> Option<V>

where V: Clone,

获取值（如果存在且未过期）

pub fn with_value<R, F>(&self, key: &K, f: F) -> Option<R>

where F: FnOnce(&V) -> R,

获取值的引用（通过闭包访问）

pub fn contains_key(&self, key: &K) -> bool

检查键是否存在（不更新访问时间）

pub fn remove(&self, key: &K) -> Option<V>

删除条目

pub fn get_or_insert_with<F>(&self, key: K, f: F) -> V

where V: Clone, F: FnOnce() -> V,

获取或插入

pub fn clear(&self)

清空缓存

pub fn len(&self) -> usize

获取当前大小

pub fn is_empty(&self) -> bool

检查是否为空

pub fn stats(&self) -> CacheStatsSnapshot

获取统计快照

pub fn reset_stats(&self)

重置统计

pub fn cleanup_expired(&self) -> usize

手动清理过期条目

pub fn keys(&self) -> Vec<K>

获取所有键

pub fn insert_many<I>(&self, items: I)

where I: IntoIterator<Item = (K, V)>,

批量插入

pub fn update<F>(&self, key: &K, f: F) -> bool

where F: FnOnce(&mut V),

更新已有条目的值（如果存在）

Trait Implementations

impl<K, V> Default for Cache<K, V>

where K: Eq + Hash + Clone,

fn default() -> Self

Returns the “default value” for a type.