Struct CacheControl 

pub struct CacheControl {
    pub no_store: bool,
    pub no_cache: bool,
    pub private: bool,
    pub must_revalidate: bool,
    pub s_maxage: Option<u64>,
    pub max_age: Option<u64>,
    pub stale_if_error: Option<u64>,
}

Parsed upstream Cache-Control directives (RFC 7234 + the stale-if-error extension, RFC 5861 section 4). Only the directives the gateway’s shared cache acts on are captured; unknown directives are ignored (forward-compat). The parser is hand-rolled (no new dependency) and tolerant: a malformed delta-seconds argument is treated as absent rather than failing the whole header, and directive names are matched case-insensitively with optional whitespace.

Fields

no_store: bool

no-store: the response MUST NOT be stored (a hard storage veto).

no_cache: bool

no-cache: store, but revalidate before every reuse (a storage veto in v1 — the gateway does not yet serve-then-revalidate, so storing an entry that can never be replayed fresh is dead weight).

private: bool

private: a shared cache MUST NOT store the response (the gateway’s cache is shared — consumer keying does not make it private, because the operator owns the cache, not the client).

must_revalidate: bool

must-revalidate: a stale response MUST NOT be served without revalidation. Recorded but not yet enforced beyond blocking the stale-while-revalidate serve path (see lookup).

s_maxage: Option<u64>

s-maxage: the freshness lifetime for SHARED caches. Takes precedence over max-age for the gateway’s shared cache (RFC 7234 section 5.2.2.9). Absent = fall back to max_age then the configured ttl_secs.

max_age: Option<u64>

max-age: the freshness lifetime for any cache. Used when s-maxage is absent.

stale_if_error: Option<u64>

stale-if-error (RFC 5861 section 4): the number of seconds PAST expiry a stale entry may be served when the upstream returns an error (5xx) or is unreachable. Absent/0 = no stale-on-error serving beyond the configured stale-while-revalidate window.

Implementations

impl CacheControl

pub fn parse(headers: &HeaderMap) -> Self

Parse every Cache-Control header value (RFC 7234 section 5.2.2). Multiple values are folded; a directive appearing more than once uses the last occurrence’s argument (matches common cache behavior). Returns an empty CacheControl when the header is absent or entirely unparseable — the caller then falls back to the configured policy.

pub fn effective_max_age(&self) -> Option<u64>

The effective shared-cache freshness lifetime, in seconds: s-maxage wins over max-age (RFC 7234 section 5.2.2.9), else None (the caller applies the configured ttl_secs).

Trait Implementations

impl Clone for CacheControl

fn clone(&self) -> CacheControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheControl

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

Formats the value using the given formatter.

impl Default for CacheControl

fn default() -> CacheControl

Returns the “default value” for a type.

impl PartialEq for CacheControl

fn eq(&self, other: &CacheControl) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CacheControl

impl StructuralPartialEq for CacheControl