4c756a9304
A bug (rust-lang/rust#23812) in rustc prevented the use of normal comments inside macros but this has been fixed.
70 lines
2.4 KiB
Rust
70 lines
2.4 KiB
Rust
use header::EntityTag;
|
|
|
|
header! {
|
|
/// `If-Match` header, defined in
|
|
/// [RFC7232](https://tools.ietf.org/html/rfc7232#section-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
|
|
/// ```plain
|
|
/// If-Match = "*" / 1#entity-tag
|
|
/// ```
|
|
///
|
|
/// # Example values
|
|
/// * `"xyzzy"`
|
|
/// * "xyzzy", "r2d2xxxx", "c3piozzzz"
|
|
///
|
|
/// # Examples
|
|
/// ```
|
|
/// use hyper::header::{Headers, IfMatch};
|
|
///
|
|
/// let mut headers = Headers::new();
|
|
/// headers.set(IfMatch::Any);
|
|
/// ```
|
|
/// ```
|
|
/// use hyper::header::{Headers, IfMatch, EntityTag};
|
|
///
|
|
/// let mut headers = Headers::new();
|
|
/// headers.set(
|
|
/// IfMatch::Items(vec![
|
|
/// EntityTag::new(false, "xyzzy".to_owned()),
|
|
/// EntityTag::new(false, "foobar".to_owned()),
|
|
/// EntityTag::new(false, "bazquux".to_owned()),
|
|
/// ])
|
|
/// );
|
|
/// ```
|
|
(IfMatch, "If-Match") => {Any / (EntityTag)+}
|
|
|
|
test_if_match {
|
|
test_header!(
|
|
test1,
|
|
vec![b"\"xyzzy\""],
|
|
Some(HeaderField::Items(
|
|
vec![EntityTag::new(false, "xyzzy".to_owned())])));
|
|
test_header!(
|
|
test2,
|
|
vec![b"\"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\""],
|
|
Some(HeaderField::Items(
|
|
vec![EntityTag::new(false, "xyzzy".to_owned()),
|
|
EntityTag::new(false, "r2d2xxxx".to_owned()),
|
|
EntityTag::new(false, "c3piozzzz".to_owned())])));
|
|
test_header!(test3, vec![b"*"], Some(IfMatch::Any));
|
|
}
|
|
}
|
|
|
|
bench_header!(star, IfMatch, { vec![b"*".to_vec()] });
|
|
bench_header!(single , IfMatch, { vec![b"\"xyzzy\"".to_vec()] });
|
|
bench_header!(multi, IfMatch,
|
|
{ vec![b"\"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\"".to_vec()] });
|