Struct CacheHeaders 

pub struct CacheHeaders {
    pub compression: bool,
    pub cache_control: Option<String>,
    pub vary: Option<String>,
}

Opt-in HTTP response-header config for CachePlugin.

Both knobs are off by default — wiring a CachePlugin without calling CachePlugin::with_compression or CachePlugin::cache_control leaves the response pipeline unchanged.

They are independent of and composable with the server-side cache_page store: cache_page caches full response bodies, while these knobs emit HTTP headers that tell downstream clients and proxies how to treat responses.

Example

App::builder()
    .plugin(
        CachePlugin::new(Cache::memory())
            .with_compression()
            .cache_control("public, max-age=3600")
            .vary("Accept-Encoding"),
    )
    .build()
    .await?;

Fields

compression: bool

When true, applies tower_http::compression::CompressionLayer to the router. The layer negotiates encoding with the client via Accept-Encoding and compresses responses with gzip, brotli, deflate, or zstd as available.

cache_control: Option<String>

When Some(value), emits a Cache-Control response header on every response (using SetResponseHeaderLayer::overriding). The value is the raw directive string, e.g. "public, max-age=3600" or "no-store".

vary: Option<String>

When Some(value), emits a Vary response header. Common value: "Accept-Encoding" to tell caches that responses differ by encoding.

Trait Implementations

impl Clone for CacheHeaders

fn clone(&self) -> CacheHeaders

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheHeaders

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

Formats the value using the given formatter.

impl Default for CacheHeaders

fn default() -> CacheHeaders

Returns the “default value” for a type.