Struct salvo_extra::caching_headers::ETag

pub struct ETag { /* private fields */ }

Available on crate feature caching-headers only.

Etag and If-None-Match header handler

Salvo handler that provides an outbound etag header after other handlers have been run, and if the request includes an if-none-match header, compares these values and sends a 304 not modified status, omitting the response body.

Streamed bodies

Note that this handler does not currently provide an etag trailer for streamed bodies, but may do so in the future.

Strong vs weak comparison

Etags can be compared using a strong method or a weak method. By default, this handler allows weak comparison. To change this setting, construct your handler with Etag::new().strong(). See etag::EntityTag for further documentation.

Read more: https://salvo.rs

Implementations

impl ETag

pub fn new() -> Self

constructs a new Etag handler

pub fn strong(self) -> Self

Configures this handler to use strong content-based etag comparison only. See etag::EntityTag for further documentation on the differences between strong and weak etag comparison.

Trait Implementations

impl Clone for ETag

fn clone(&self) -> ETag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ETag

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

Formats the value using the given formatter.

impl Default for ETag

fn default() -> ETag

Returns the “default value” for a type.

impl Handler for ETag

fn handle<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 self, req: &'life1 mut Request, depot: &'life2 mut Depot, res: &'life3 mut Response, ctrl: &'life4 mut FlowCtrl ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait,

Handle http request.

impl Copy for ETag