cogo_http/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 /// ```plain
13 /// Referer = absolute-URI / partial-URI
14 /// ```
15 ///
16 /// # Example values
17 /// * `http://www.example.org/hypertext/Overview.html`
18 ///
19 /// # Examples
20 /// ```
21 /// use cogo_http::header::{Headers, Referer};
22 ///
23 /// let mut headers = Headers::new();
24 /// headers.set(Referer("/People.html#tim".to_owned()));
25 /// ```
26 /// ```
27 /// use cogo_http::header::{Headers, Referer};
28 ///
29 /// let mut headers = Headers::new();
30 /// headers.set(Referer("http://www.example.com/index.html".to_owned()));
31 /// ```
32 // TODO Use URL
33 (Referer, "Referer") => [String]
34
35 test_referer {
36 // Testcase from the RFC
37 test_header!(test1, vec![b"http://www.example.org/hypertext/Overview.html"]);
38 }
39}
40
41bench_header!(bench, Referer, { vec![b"http://foo.com/hello:3000".to_vec()] });