Enum IfMatch 

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

If-Match header, defined in RFC 7232 §3.1

The If-Match header field makes the request method conditional on the recipient origin server either having at least one current representation of the target resource, when the field-value is “*”, or having a current representation of the target resource that has an entity-tag matching a member of the list of entity-tags provided in the field-value.

An origin server MUST use the strong comparison function when comparing entity-tags for If-Match, since the client intends this precondition to prevent the method from being applied if there have been any changes to the representation data.

Note

This is a request header used for conditional requests (typically to avoid lost updates). Servers should not send If-Match in responses; use ETag to describe the current representation instead.

ABNF

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

Example Values

• "xyzzy"
• “xyzzy”, “r2d2xxxx”, “c3piozzzz”

Examples

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

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

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

let req = test::TestRequest::default()
    .insert_header(IfMatch::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 IfMatch

fn clone(&self) -> IfMatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IfMatch

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

Formats the value using the given formatter.

impl Display for IfMatch

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

Formats the value using the given formatter.

impl Header for IfMatch

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 IfMatch

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

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 IfMatch

impl StructuralPartialEq for IfMatch