Enum IfNoneMatch 

pub enum IfNoneMatch {
    Any,
    Items(Vec<EntityTag>),
}

If-None-Match header, defined in RFC 7232 §3.2

The If-None-Match header field makes the request method conditional on a recipient cache or origin server either not having any current representation of the target resource, when the field-value is “*”, or having a selected representation with an entity-tag that does not match any of those listed in the field-value.

A recipient MUST use the weak comparison function when comparing entity-tags for If-None-Match (Section 2.3.2), since weak entity-tags can be used for cache validation even if there have been changes to the representation data.

Note

This is a request header used for cache validation (and conditional requests). Servers should not send If-None-Match in responses; use ETag to describe the current representation instead.

ABNF

If-None-Match = "*" / 1#entity-tag

Example Values

• "xyzzy"
• W/"xyzzy"
• "xyzzy", "r2d2xxxx", "c3piozzzz"
• W/"xyzzy", W/"r2d2xxxx", W/"c3piozzzz"
• *

Examples

use actix_web::{http::header::IfNoneMatch, test};

let req = test::TestRequest::default()
    .insert_header(IfNoneMatch::Any)
    .to_http_request();

use actix_web::{http::header::{EntityTag, IfNoneMatch}, test};

let req = test::TestRequest::default()
    .insert_header(IfNoneMatch::Items(vec![
        EntityTag::new(false, "xyzzy".to_owned()),
        EntityTag::new(false, "foobar".to_owned()),
        EntityTag::new(false, "bazquux".to_owned()),
    ]))
    .to_http_request();

Variants

Any

Any value is a match

Items(Vec<EntityTag>)

Only the listed items are a match

Trait Implementations

impl Clone for IfNoneMatch

fn clone(&self) -> IfNoneMatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IfNoneMatch

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

Formats the value using the given formatter.

impl Display for IfNoneMatch

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

Formats the value using the given formatter.

impl Header for IfNoneMatch

fn name() -> HeaderName

Returns the name of the header field.

fn parse<M: HttpMessage>(msg: &M) -> Result<Self, ParseError>

Parse the header from a HTTP message.

impl PartialEq for IfNoneMatch

fn eq(&self, other: &IfNoneMatch) -> 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 TryIntoHeaderValue for IfNoneMatch

type Error = InvalidHeaderValue

The type returned in the event of a conversion error.

fn try_into_value(self) -> Result<HeaderValue, Self::Error>

Try to convert value to a HeaderValue.

impl Eq for IfNoneMatch

impl StructuralPartialEq for IfNoneMatch