1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
use header::{Header, Raw}; use std::fmt; use std::str::from_utf8; /// `Set-Cookie` header, defined [RFC6265](http://tools.ietf.org/html/rfc6265#section-4.1) /// /// The Set-Cookie HTTP response header is used to send cookies from the /// server to the user agent. /// /// Informally, the Set-Cookie response header contains the header name /// "Set-Cookie" followed by a ":" and a cookie. Each cookie begins with /// a name-value-pair, followed by zero or more attribute-value pairs. /// /// # ABNF /// /// ```text /// set-cookie-header = "Set-Cookie:" SP set-cookie-string /// set-cookie-string = cookie-pair *( ";" SP cookie-av ) /// cookie-pair = cookie-name "=" cookie-value /// cookie-name = token /// cookie-value = *cookie-octet / ( DQUOTE *cookie-octet DQUOTE ) /// cookie-octet = %x21 / %x23-2B / %x2D-3A / %x3C-5B / %x5D-7E /// ; US-ASCII characters excluding CTLs, /// ; whitespace DQUOTE, comma, semicolon, /// ; and backslash /// token = <token, defined in [RFC2616], Section 2.2> /// /// cookie-av = expires-av / max-age-av / domain-av / /// path-av / secure-av / httponly-av / /// extension-av /// expires-av = "Expires=" sane-cookie-date /// sane-cookie-date = <rfc1123-date, defined in [RFC2616], Section 3.3.1> /// max-age-av = "Max-Age=" non-zero-digit *DIGIT /// ; In practice, both expires-av and max-age-av /// ; are limited to dates representable by the /// ; user agent. /// non-zero-digit = %x31-39 /// ; digits 1 through 9 /// domain-av = "Domain=" domain-value /// domain-value = <subdomain> /// ; defined in [RFC1034], Section 3.5, as /// ; enhanced by [RFC1123], Section 2.1 /// path-av = "Path=" path-value /// path-value = <any CHAR except CTLs or ";"> /// secure-av = "Secure" /// httponly-av = "HttpOnly" /// extension-av = <any CHAR except CTLs or ";"> /// ``` /// /// # Example values /// /// * `SID=31d4d96e407aad42` /// * `lang=en-US; Expires=Wed, 09 Jun 2021 10:18:14 GMT` /// * `lang=; Expires=Sun, 06 Nov 1994 08:49:37 GMT` /// * `lang=en-US; Path=/; Domain=example.com` /// /// # Example /// /// ``` /// use hyper::header::{Headers, SetCookie}; /// /// let mut headers = Headers::new(); /// /// headers.set( /// SetCookie(vec![ /// String::from("foo=bar; Path=/path; Domain=example.com") /// ]) /// ); /// ``` #[derive(Clone, PartialEq, Debug)] pub struct SetCookie(pub Vec<String>); __hyper__deref!(SetCookie => Vec<String>); impl Header for SetCookie { fn header_name() -> &'static str { static NAME: &'static str = "Set-Cookie"; NAME } fn parse_header(raw: &Raw) -> ::Result<SetCookie> { let mut set_cookies = Vec::with_capacity(raw.len()); for set_cookies_raw in raw { if let Ok(s) = from_utf8(&set_cookies_raw[..]) { set_cookies.push(s.trim().to_owned()); } } if !set_cookies.is_empty() { Ok(SetCookie(set_cookies)) } else { Err(::Error::Header) } } fn fmt_header(&self, f: &mut ::header::Formatter) -> fmt::Result { for cookie in &self.0 { try!(f.fmt_line(cookie)); } Ok(()) } } #[test] fn test_set_cookie_fmt() { use ::header::Headers; let mut headers = Headers::new(); headers.set(SetCookie(vec![ "foo=bar".into(), "baz=quux".into(), ])); assert_eq!(headers.to_string(), "Set-Cookie: foo=bar\r\nSet-Cookie: baz=quux\r\n"); }