hyper_sync/header/common/
transfer_encoding.rs

1use header::Encoding;
2
3header! {
4    /// `Transfer-Encoding` header, defined in
5    /// [RFC7230](http://tools.ietf.org/html/rfc7230#section-3.3.1)
6    /// 
7    /// The `Transfer-Encoding` header field lists the transfer coding names
8    /// corresponding to the sequence of transfer codings that have been (or
9    /// will be) applied to the payload body in order to form the message
10    /// body.
11    ///
12    /// Note that setting this header will *remove* any previously set
13    /// `Content-Length` header, in accordance with
14    /// [RFC7230](http://tools.ietf.org/html/rfc7230#section-3.3.2):
15    ///
16    /// > A sender MUST NOT send a Content-Length header field in any message
17    /// > that contains a Transfer-Encoding header field.
18    /// 
19    /// # ABNF
20    ///
21    /// ```text
22    /// Transfer-Encoding = 1#transfer-coding
23    /// ```
24    /// 
25    /// # Example values
26    ///
27    /// * `gzip, chunked`
28    /// 
29    /// # Example
30    ///
31    /// ```
32    /// use hyper_sync::header::{Headers, TransferEncoding, Encoding};
33    /// 
34    /// let mut headers = Headers::new();
35    /// headers.set(
36    ///     TransferEncoding(vec![
37    ///         Encoding::Gzip,
38    ///         Encoding::Chunked,
39    ///     ])
40    /// );
41    /// ```
42    (TransferEncoding, "Transfer-Encoding") => (Encoding)+
43
44    transfer_encoding {
45        test_header!(
46            test1,
47            vec![b"gzip, chunked"],
48            Some(HeaderField(
49                vec![Encoding::Gzip, Encoding::Chunked]
50                )));
51        // Issue: #683
52        test_header!(
53            test2,
54            vec![b"chunked", b"chunked"],
55            Some(HeaderField(
56                vec![Encoding::Chunked, Encoding::Chunked]
57            )));
58
59    }
60}
61
62impl TransferEncoding {
63    /// Constructor for the most common Transfer-Encoding, `chunked`.
64    pub fn chunked() -> TransferEncoding {
65        TransferEncoding(vec![Encoding::Chunked])
66    }
67}
68
69bench_header!(normal, TransferEncoding, { vec![b"chunked, gzip".to_vec()] });
70bench_header!(ext, TransferEncoding, { vec![b"ext".to_vec()] });
hyper_sync/header/common/transfer_encoding.rs

hyper_sync/header/common/
transfer_encoding.rs
