hyperx/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` 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    /// # extern crate http;
25    /// use hyperx::header::{Referer, TypedHeaders};
26    ///
27    /// let mut headers = http::HeaderMap::new();
28    /// headers.encode(&Referer::new("/People.html#tim"));
29    /// ```
30    ///
31    /// ```
32    /// # extern crate http;
33    /// use hyperx::header::{Referer, TypedHeaders};
34    ///
35    /// let mut headers = http::HeaderMap::new();
36    /// headers.encode(&Referer::new("http://www.example.com/index.html"));
37    /// ```
38    // TODO Use URL
39    (Referer, "Referer") => Cow[str]
40
41    test_referer {
42        // Testcase from the RFC
43        test_header!(test1, vec![b"http://www.example.org/hypertext/Overview.html"]);
44    }
45}
46
47bench_header!(bench, Referer, { vec![b"http://foo.com/hello:3000".to_vec()] });
48
49standard_header!(Referer, REFERER);