Expand description
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.
ABNF
If-Match = "*" / 1#entity-tag
Example Values
"xyzzy"
- “xyzzy”, “r2d2xxxx”, “c3piozzzz”
Examples
use actix_web::HttpResponse;
use actix_web::http::header::IfMatch;
let mut builder = HttpResponse::Ok();
builder.insert_header(IfMatch::Any);
use actix_web::HttpResponse;
use actix_web::http::header::{IfMatch, EntityTag};
let mut builder = HttpResponse::Ok();
builder.insert_header(
IfMatch::Items(vec![
EntityTag::new(false, "xyzzy".to_owned()),
EntityTag::new(false, "foobar".to_owned()),
EntityTag::new(false, "bazquux".to_owned()),
])
);
Variants
Any
Any value is a match
Items(Vec<EntityTag>)
Only the listed items are a match
Trait Implementations
sourceimpl Header for IfMatch
impl Header for IfMatch
sourcefn name() -> HeaderName
fn name() -> HeaderName
Returns the name of the header field.
sourcefn parse<M: HttpMessage>(msg: &M) -> Result<Self, ParseError>
fn parse<M: HttpMessage>(msg: &M) -> Result<Self, ParseError>
Parse the header from a HTTP message.
sourceimpl PartialEq<IfMatch> for IfMatch
impl PartialEq<IfMatch> for IfMatch
sourceimpl TryIntoHeaderValue for IfMatch
impl TryIntoHeaderValue for IfMatch
type Error = InvalidHeaderValue
type Error = InvalidHeaderValue
The type returned in the event of a conversion error.
sourcefn try_into_value(self) -> Result<HeaderValue, Self::Error>
fn try_into_value(self) -> Result<HeaderValue, Self::Error>
Try to convert value to a HeaderValue.
impl Eq for IfMatch
impl StructuralEq for IfMatch
impl StructuralPartialEq for IfMatch
Auto Trait Implementations
impl RefUnwindSafe for IfMatch
impl Send for IfMatch
impl Sync for IfMatch
impl Unpin for IfMatch
impl UnwindSafe for IfMatch
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to key
and return true
if they are equal.
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> TryIntoHeaderPair for Twhere
T: Header,
impl<T> TryIntoHeaderPair for Twhere
T: Header,
type Error = <T as TryIntoHeaderValue>::Error
fn try_into_pair(
self
) -> Result<(HeaderName, HeaderValue), <T as TryIntoHeaderPair>::Error>
impl<V, T> VZip<V> for Twhere
V: MultiLane<T>,
impl<V, T> VZip<V> for Twhere
V: MultiLane<T>,
fn vzip(self) -> V
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more