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);