1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
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 /// /// ```text /// 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()] });