headers_ext/common/
access_control_allow_headers.rs

1use std::iter::FromIterator;
2
3use {HeaderName, HeaderValue};
4use util::FlatCsv;
5
6/// `Access-Control-Allow-Headers` header, part of
7/// [CORS](http://www.w3.org/TR/cors/#access-control-allow-headers-response-header)
8///
9/// The `Access-Control-Allow-Headers` header indicates, as part of the
10/// response to a preflight request, which header field names can be used
11/// during the actual request.
12///
13/// # ABNF
14///
15/// ```text
16/// Access-Control-Allow-Headers: "Access-Control-Allow-Headers" ":" #field-name
17/// ```
18///
19/// # Example values
20/// * `accept-language, date`
21///
22/// # Examples
23///
24/// ```
25/// # extern crate headers_ext as headers;
26/// extern crate http;
27/// use http::header::{CACHE_CONTROL, CONTENT_TYPE};
28/// use headers::AccessControlAllowHeaders;
29///
30/// let allow_headers = vec![CACHE_CONTROL, CONTENT_TYPE]
31///     .into_iter()
32///     .collect::<AccessControlAllowHeaders>();
33/// ```
34#[derive(Clone, Debug, PartialEq, Header)]
35pub struct AccessControlAllowHeaders(FlatCsv);
36
37impl AccessControlAllowHeaders {
38    /// Returns an iterator over `HeaderName`s contained within.
39    pub fn iter<'a>(&'a self) -> impl Iterator<Item = HeaderName> + 'a {
40        self
41            .0
42            .iter()
43            .map(|s| {
44                s.parse().ok()
45            })
46            .take_while(|val| val.is_some())
47            .filter_map(|val| val)
48    }
49}
50
51impl FromIterator<HeaderName> for AccessControlAllowHeaders {
52    fn from_iter<I>(iter: I) -> Self
53    where
54        I: IntoIterator<Item = HeaderName>,
55    {
56        let flat = iter
57            .into_iter()
58            .map(HeaderValue::from)
59            .collect();
60        AccessControlAllowHeaders(flat)
61    }
62}
63
64#[cfg(test)]
65mod tests {
66    use super::*;
67    use super::super::{test_decode, test_encode};
68
69    #[test]
70    fn iter() {
71        let allow_headers = test_decode::<AccessControlAllowHeaders>(
72            &["foo, bar"]
73        ).unwrap();
74
75        let as_vec = allow_headers.iter().collect::<Vec<_>>();
76        assert_eq!(as_vec.len(), 2);
77        assert_eq!(as_vec[0], "foo");
78        assert_eq!(as_vec[1], "bar");
79    }
80
81    #[test]
82    fn from_iter() {
83        let allow: AccessControlAllowHeaders = vec![
84            ::http::header::CACHE_CONTROL,
85            ::http::header::IF_RANGE,
86        ].into_iter().collect();
87
88        let headers = test_encode(allow);
89        assert_eq!(headers["access-control-allow-headers"], "cache-control, if-range");
90    }
91
92    #[test]
93    fn test_with_invalid() {
94        let allow_headers = test_decode::<AccessControlAllowHeaders>(
95            &["foo foo, bar"]
96        ).unwrap();
97
98        assert!(allow_headers.iter().collect::<Vec<_>>().is_empty());
99    }
100}
101