hyper_sync/header/common/referer.rs
1header! {
2 /// `Referer` header, defined in
3 /// [RFC7231](http://tools.ietf.org/html/rfc7231#section-5.5.2)
4 ///
5 /// The `Referer` [sic] header field allows the user agent to specify a
6 /// URI reference for the resource from which the target URI was obtained
7 /// (i.e., the "referrer", though the field name is misspelled). A user
8 /// agent MUST NOT include the fragment and userinfo components of the
9 /// URI reference, if any, when generating the Referer field value.
10 ///
11 /// # ABNF
12 ///
13 /// ```text
14 /// Referer = absolute-URI / partial-URI
15 /// ```
16 ///
17 /// # Example values
18 ///
19 /// * `http://www.example.org/hypertext/Overview.html`
20 ///
21 /// # Examples
22 ///
23 /// ```
24 /// use hyper_sync::header::{Headers, Referer};
25 ///
26 /// let mut headers = Headers::new();
27 /// headers.set(Referer::new("/People.html#tim"));
28 /// ```
29 ///
30 /// ```
31 /// use hyper_sync::header::{Headers, Referer};
32 ///
33 /// let mut headers = Headers::new();
34 /// headers.set(Referer::new("http://www.example.com/index.html"));
35 /// ```
36 // TODO Use URL
37 (Referer, "Referer") => Cow[str]
38
39 test_referer {
40 // Testcase from the RFC
41 test_header!(test1, vec![b"http://www.example.org/hypertext/Overview.html"]);
42 }
43}
44
45bench_header!(bench, Referer, { vec![b"http://foo.com/hello:3000".to_vec()] });