Struct HtmlCache 

struct HtmlCache {
    pages: Cache<String, CachedPage>,
    generation: AtomicU64,
    gate: Mutex<()>,
    enabled: bool,
    max_page_bytes: usize,
    namespace: Mutex<String>,
}

Fields

pages: Cache<String, CachedPage>

generation: AtomicU64

gate: Mutex<()>

enabled: bool

max_page_bytes: usize

单页上限：渲染结果更大的页面不缓存，每次请求完整 SSR 再现压。

namespace: Mutex<String>

当前缓存命名空间（release×flavor，plan §6.7）。空串 = 尚未初始化。

Implementations

impl HtmlCache

fn new(ttl: Duration, capacity: u64, max_page_bytes: usize) -> Self

fn generation(&self) -> u64

fn invalidate(&self) -> u64

fn swap_namespace(&self, namespace: &str) -> bool

切换命名空间：内容不同则整表失效并推进世代，保证旧命名空间下的已缓存 页面与在途回填都绝不返回给新命名空间（plan §6.7「release/flavor 纳入隔离」）。 同一进程内一个缓存实例只服务一个 release×flavor 组合，切换只发生在 启动/开发热重载重新组装路由时。返回是否真的发生了切换。

fn get(&self, path: &str) -> Option<CachedPage>

fn insert( &self, path: String, headers: HeaderMap, body: Vec<u8>, generation: u64, ) -> Option<(HeaderValue, Bytes)>

新写入时返回 ETag 与正文，供调用方预压缩；同世代已有相同内容（并发未命中的 先到者已写入）时不覆盖，返回 None，避免重复预压缩并保留已补齐的变体。

fn attach_encoded( &self, path: &str, etag: &HeaderValue, generation: u64, encoded: Vec<(Encoding, Bytes)>, )

补上预压缩变体；页面已失效、过期或被不同内容替换时丢弃。