Trait CachingHeadersExt 

pub trait CachingHeadersExt: Sized {
    // Required methods
    fn etag(&self) -> Option<EntityTag>;
    fn set_etag(&mut self, entity_tag: &EntityTag);
    fn last_modified(&self) -> Option<SystemTime>;
    fn set_last_modified(&mut self, system_time: SystemTime);
    fn cache_control(&self) -> Option<CacheControlHeader>;
    fn set_cache_control(
        &mut self,
        cache_control: impl Into<CacheControlHeader>,
    );
    fn cdn_cache_control(&self) -> Option<CacheControlHeader>;
    fn set_cdn_cache_control(
        &mut self,
        cache_control: impl Into<CacheControlHeader>,
    );
    fn if_modified_since(&self) -> Option<SystemTime>;
    fn if_none_match(&self) -> Option<EntityTag>;
    fn set_vary<I, N>(&mut self, vary: I)
       where I: IntoIterator<Item = N>,
             N: Into<HeaderName<'static>>;

    // Provided methods
    fn with_cache_control(
        self,
        cache_control: impl Into<CacheControlHeader>,
    ) -> Self { ... }
    fn with_last_modified(self, system_time: SystemTime) -> Self { ... }
    fn with_etag(self, entity_tag: &EntityTag) -> Self { ... }
    fn with_vary<I, N>(self, vary: I) -> Self
       where I: IntoIterator<Item = N>,
             N: Into<HeaderName<'static>> { ... }
    fn with_cdn_cache_control(
        self,
        cache_control: impl Into<CacheControlHeader>,
    ) -> Self { ... }
}

Provides an extension trait for both trillium::Headers and also trillium::Conn for setting and getting various parsed caching headers.

Required Methods

fn etag(&self) -> Option<EntityTag>

returns an EntityTag if these headers contain an Etag header.

fn set_etag(&mut self, entity_tag: &EntityTag)

sets an etag header from an EntityTag.

fn last_modified(&self) -> Option<SystemTime>

returns a parsed timestamp if these headers contain a Last-Modified header.

fn set_last_modified(&mut self, system_time: SystemTime)

sets a formatted Last-Modified header from a timestamp.

fn cache_control(&self) -> Option<CacheControlHeader>

Returns a parsed CacheControlHeader if these headers include a Cache-Control header. Note that if this is called on a Conn, it returns the request’s Cache-Control header.

fn set_cache_control(&mut self, cache_control: impl Into<CacheControlHeader>)

sets a Cache-Control header on these headers. Note that this is valid in both request and response contexts, and specific directives have different meanings.

fn cdn_cache_control(&self) -> Option<CacheControlHeader>

Returns a parsed CacheControlHeader if these headers include a CDN-Cache-Control header (RFC 9213). Unlike cache_control, CDN-Cache-Control is response-only by spec, so when called on a Conn this reads the response headers.

fn set_cdn_cache_control( &mut self, cache_control: impl Into<CacheControlHeader>, )

Sets a CDN-Cache-Control (RFC 9213) header on these headers. Targeted at CDN / shared-intermediary caches, ignored by other caches.

fn if_modified_since(&self) -> Option<SystemTime>

returns a parsed If-Modified-Since header if one exists

fn if_none_match(&self) -> Option<EntityTag>

returns a parsed EntityTag header if there is an If-None-Match header.

fn set_vary<I, N>(&mut self, vary: I)

where I: IntoIterator<Item = N>, N: Into<HeaderName<'static>>,

sets the Vary header to a collection of Into<HeaderName>

Provided Methods

fn with_cache_control( self, cache_control: impl Into<CacheControlHeader>, ) -> Self

chainable method to set cache control and return self. primarily useful on Conn

fn with_last_modified(self, system_time: SystemTime) -> Self

chainable method to set last modified and return self. primarily useful on Conn

fn with_etag(self, entity_tag: &EntityTag) -> Self

chainable method to set etag and return self. primarily useful on Conn

fn with_vary<I, N>(self, vary: I) -> Self

where I: IntoIterator<Item = N>, N: Into<HeaderName<'static>>,

chainable method to set vary and return self. primarily useful on Conn

fn with_cdn_cache_control( self, cache_control: impl Into<CacheControlHeader>, ) -> Self

chainable method to set CDN-Cache-Control and return self. primarily useful on Conn

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl CachingHeadersExt for Conn

fn etag(&self) -> Option<EntityTag>

fn set_etag(&mut self, entity_tag: &EntityTag)

fn last_modified(&self) -> Option<SystemTime>

fn set_last_modified(&mut self, system_time: SystemTime)

fn cache_control(&self) -> Option<CacheControlHeader>

fn set_cache_control(&mut self, cache_control: impl Into<CacheControlHeader>)

fn cdn_cache_control(&self) -> Option<CacheControlHeader>

fn set_cdn_cache_control( &mut self, cache_control: impl Into<CacheControlHeader>, )

fn if_modified_since(&self) -> Option<SystemTime>

fn if_none_match(&self) -> Option<EntityTag>

fn set_vary<I, N>(&mut self, vary: I)

where I: IntoIterator<Item = N>, N: Into<HeaderName<'static>>,

impl CachingHeadersExt for Headers

fn etag(&self) -> Option<EntityTag>

fn set_etag(&mut self, entity_tag: &EntityTag)

fn last_modified(&self) -> Option<SystemTime>

fn set_last_modified(&mut self, system_time: SystemTime)

fn cache_control(&self) -> Option<CacheControlHeader>

fn set_cache_control(&mut self, cache_control: impl Into<CacheControlHeader>)

fn cdn_cache_control(&self) -> Option<CacheControlHeader>

fn set_cdn_cache_control( &mut self, cache_control: impl Into<CacheControlHeader>, )

fn if_modified_since(&self) -> Option<SystemTime>

fn if_none_match(&self) -> Option<EntityTag>

fn set_vary<I, N>(&mut self, vary: I)

where I: IntoIterator<Item = N>, N: Into<HeaderName<'static>>,

Implementors