cogo_http/header/common/
host.rs

1use crate::header::{Header, HeaderFormat};
2use std::fmt;
3use std::str::FromStr;
4use crate::header::parsing::from_one_raw_str;
5use url::idna::domain_to_unicode;
6
7/// The `Host` header.
8///
9/// HTTP/1.1 requires that all requests include a `Host` header, and so hyper
10/// client requests add one automatically.
11///
12/// Currently is just a String, but it should probably become a better type,
13/// like `url::Host` or something.
14///
15/// # Examples
16/// ```
17/// use cogo_http::header::{Headers, Host};
18///
19/// let mut headers = Headers::new();
20/// headers.set(
21///     Host{
22///         hostname: "hyper.rs".to_owned(),
23///         port: None,
24///     }
25/// );
26/// ```
27/// ```
28/// use cogo_http::header::{Headers, Host};
29///
30/// let mut headers = Headers::new();
31/// headers.set(
32///     Host{
33///         hostname: "hyper.rs".to_owned(),
34///         port: Some(8080),
35///     }
36/// );
37/// ```
38#[derive(Clone, PartialEq, Debug)]
39pub struct Host {
40    /// The hostname, such a example.domain.
41    pub hostname: String,
42    /// An optional port number.
43    pub port: Option<u16>
44}
45
46impl Header for Host {
47    fn header_name() -> &'static str {
48        "Host"
49    }
50
51    fn parse_header(raw: &[Vec<u8>]) -> crate::Result<Host> {
52        from_one_raw_str(raw)
53    }
54}
55
56impl HeaderFormat for Host {
57    fn fmt_header(&self, f: &mut fmt::Formatter) -> fmt::Result {
58        match self.port {
59            None | Some(80) | Some(443) => f.write_str(&self.hostname[..]),
60            Some(port) => write!(f, "{}:{}", self.hostname, port)
61        }
62    }
63}
64
65impl fmt::Display for Host {
66    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
67        self.fmt_header(f)
68    }
69}
70
71impl FromStr for Host {
72    type Err = crate::Error;
73
74    fn from_str(s: &str) -> crate::Result<Host> {
75        let idx = s.rfind(':');
76        let port = idx.and_then(
77            |idx| s[idx + 1..].parse().ok()
78        );
79        let hostname_encoded = match port {
80            None => s,
81            Some(_) => &s[..idx.unwrap()]
82        };
83
84        let hostname = if hostname_encoded.starts_with("[") {
85            if !hostname_encoded.ends_with("]") {
86                return Err(crate::Error::Header)
87            }
88            hostname_encoded.to_owned()
89        } else {
90            let (hostname, res) = domain_to_unicode(hostname_encoded);
91            if res.is_err() {
92                return Err(crate::Error::Header)
93            }
94            hostname
95        };
96
97        Ok(Host {
98            hostname: hostname,
99            port: port
100        })
101    }
102}
103
104#[cfg(test)]
105mod tests {
106    use super::Host;
107    use crate::header::Header;
108
109
110    #[test]
111    fn test_host() {
112        let host = Header::parse_header([b"foo.com".to_vec()].as_ref());
113        assert_eq!(host.ok(), Some(Host {
114            hostname: "foo.com".to_owned(),
115            port: None
116        }));
117
118
119        let host = Header::parse_header([b"foo.com:8080".to_vec()].as_ref());
120        assert_eq!(host.ok(), Some(Host {
121            hostname: "foo.com".to_owned(),
122            port: Some(8080)
123        }));
124
125        let host = Header::parse_header([b"foo.com".to_vec()].as_ref());
126        assert_eq!(host.ok(), Some(Host {
127            hostname: "foo.com".to_owned(),
128            port: None
129        }));
130
131        let host = Header::parse_header([b"[::1]:8080".to_vec()].as_ref());
132        assert_eq!(host.ok(), Some(Host {
133            hostname: "[::1]".to_owned(),
134            port: Some(8080)
135        }));
136
137        let host = Header::parse_header([b"[::1]".to_vec()].as_ref());
138        assert_eq!(host.ok(), Some(Host {
139            hostname: "[::1]".to_owned(),
140            port: None
141        }));
142    }
143}
144
145bench_header!(bench, Host, { vec![b"foo.com:3000".to_vec()] });
cogo_http/header/common/host.rs

cogo_http/header/common/
host.rs
