Struct CacheControlConfig 

pub struct CacheControlConfig {
    pub max_age: Option<u64>,
    pub visibility: Option<CacheVisibility>,
    pub no_cache: bool,
    pub no_store: bool,
    pub must_revalidate: bool,
    pub immutable: bool,
}

Cache-Control 配置（对齐 nginx expires 指令）

对齐 nginx 配置：

• expires 1h; → Cache-Control: max-age=3600
• expires -1; → Cache-Control: no-cache
• expires off; → 不设置 Cache-Control
• add_header Cache-Control "public"; → Cache-Control: public

Fields

max_age: Option<u64>

max-age（秒），None 表示不设置 max-age

visibility: Option<CacheVisibility>

public（公共缓存，CDN 可缓存）/ private（仅浏览器缓存）/ None

no_cache: bool

no-cache（必须重新验证）/ no-store（完全不缓存）

no_store: bool

完全不缓存

must_revalidate: bool

must-revalidate（过期后必须重新验证）

immutable: bool

immutable（文件永不变化，浏览器可永久缓存，对齐前端构建工具指纹 hash 场景）

Implementations

impl CacheControlConfig

pub fn new() -> Self

创建空配置（不设置任何 Cache-Control 指令）

pub fn with_max_age(self, seconds: u64) -> Self

设置 max-age（秒）

pub fn with_public(self) -> Self

设置 public

pub fn with_private(self) -> Self

设置 private

pub fn with_no_cache(self) -> Self

设置 no-cache（必须重新验证）

pub fn with_no_store(self) -> Self

设置 no-store（完全不缓存）

pub fn with_must_revalidate(self) -> Self

设置 must-revalidate

pub fn with_immutable(self) -> Self

设置 immutable（对齐前端构建工具指纹 hash 场景）

pub fn to_header_value(&self) -> Option<String>

生成 Cache-Control 头值

返回 None 表示配置为空（不设置 Cache-Control 头）。

Trait Implementations

impl Clone for CacheControlConfig

fn clone(&self) -> CacheControlConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheControlConfig

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

Formats the value using the given formatter.

impl Default for CacheControlConfig

fn default() -> CacheControlConfig

Returns the “default value” for a type.