Struct CacheHeaders 

pub struct CacheHeaders {
    pub cache_control: String,
    pub etag: Option<String>,
    pub last_modified: Option<String>,
    pub vary: Option<String>,
    pub cdn_cache_control: Option<String>,
    pub surrogate_control: Option<String>,
}

A complete set of cache-related HTTP response headers.

Fields

cache_control: String

Value of the Cache-Control header.

etag: Option<String>

Value of the ETag header, if any.

last_modified: Option<String>

Value of the Last-Modified header (HTTP date), if any.

vary: Option<String>

Value of the Vary header, if any.

cdn_cache_control: Option<String>

Value of the CDN-Cache-Control header, if any.

surrogate_control: Option<String>

Value of the Surrogate-Control header (Varnish/Fastly), if any.

Implementations

impl CacheHeaders

pub fn new(policy: CachePolicy) -> Self

Creates a new CacheHeaders from a CachePolicy.

pub fn with_etag(self, etag: ETag) -> Self

Attaches an ETag header (builder-style).

pub fn with_last_modified(self, unix_secs: u64) -> Self

Attaches a Last-Modified header derived from a Unix timestamp (builder-style).

pub fn with_vary(self, vary: VaryHeader) -> Self

Attaches a Vary header (builder-style).

pub fn with_cdn_override(self, cdn_max_age_secs: u32) -> Self

Adds CDN-specific override headers (CDN-Cache-Control and Surrogate-Control) with a custom max-age (builder-style).

pub fn is_not_modified(&self, if_none_match: Option<&str>) -> bool

Returns true if the request’s If-None-Match value matches this response’s ETag, indicating the client’s copy is still valid (→ 304).

pub fn to_header_pairs(&self) -> Vec<(String, String)>

Returns all set headers as (name, value) pairs.

Cache-Control is always included. All other headers are omitted when not set.

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.