Enum IfNoneMatch 

pub enum IfNoneMatch {
    Any,
    Tags(Vec<ETag>),
}

Models the If-None-Match conditional request header (RFC 7232 §3.2).

A request with If-None-Match: * fails if any representation exists. A request with a list of ETags fails (i.e., condition is false) if the current ETag matches any of the listed ETags (weak comparison).

Variants

Any

Condition fails if any representation exists (If-None-Match: *).

Tags(Vec<ETag>)

Condition fails if the current ETag weakly matches any of these.

Implementations

impl IfNoneMatch

pub fn matches(&self, current: &ETag) -> bool

Returns true when the condition is satisfied (i.e., the server should proceed with the request).

Per RFC 7232 §3.2, the condition is satisfied when the current ETag does not weakly match any tag in the list (or no representation exists for Any).

use api_bones::etag::{ETag, IfNoneMatch};

// Wildcard is never satisfied (any representation exists).
assert!(!IfNoneMatch::Any.matches(&ETag::strong("v1")));

// Satisfied when current tag is NOT in the list.
let cond = IfNoneMatch::Tags(vec![ETag::strong("v1")]);
assert!(cond.matches(&ETag::strong("v2")));
assert!(!cond.matches(&ETag::strong("v1")));

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<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IfNoneMatch

fn deserialize<__D>( __deserializer: __D, ) -> Result<IfNoneMatch, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S> FromRequestParts<S> for IfNoneMatch

where S: Send + Sync,

type Rejection = ApiError

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<IfNoneMatch, <IfNoneMatch as FromRequestParts<S>>::Rejection>

Perform the extraction.

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 Serialize for IfNoneMatch

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for IfNoneMatch

impl StructuralPartialEq for IfNoneMatch