Struct L1Cache 

pub struct L1Cache<T> { /* private fields */ }

L1 一级缓存（Session 级别 Identity Map）

• Identity Map：相同主键返回相同 Arc<T> 引用
• LRU 淘汰：超过 capacity 时淘汰最久未使用条目
• 无锁统计：AtomicU64 原子计数，并发安全
• Session 绑定：非 Send + Sync，不跨线程共享（Session 内使用）

泛型参数 T 为缓存值类型，主键类型固定为 i64（与 Model::PrimaryKey 对齐）。

Implementations

impl<T> L1Cache<T>

pub fn new(capacity: usize) -> Self

创建 L1 缓存，指定容量上限

当缓存条目数超过 capacity 时，淘汰最久未使用条目（LRU）。

pub fn capacity(&self) -> usize

获取容量上限

pub fn put(&mut self, key: i64, value: Arc<T>)

存入缓存项（Identity Map 语义：同主键返回同引用）

如果主键已存在，更新值并移到 LRU 尾部（最近使用）。 如果超过容量上限，淘汰 LRU 头部（最久未使用）条目。

pub fn get(&mut self, key: &i64) -> Option<Arc<T>>

查询缓存项（Identity Map 语义：同主键返回同 Arc 引用）

命中时更新 LRU 顺序（移到尾部），未命中时递增 miss 计数。

pub fn evict(&mut self, key: &i64)

手动失效单个缓存项

pub fn clear(&mut self)

清空所有缓存项

pub fn len(&self) -> usize

当前缓存条目数量

pub fn is_empty(&self) -> bool

缓存是否为空

pub fn stats(&self) -> L1CacheStats

获取统计快照（无锁原子读取）

Trait Implementations

impl<T> Default for L1Cache<T>

fn default() -> Self

Returns the “default value” for a type.