You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

299 lines
6.2 KiB

  1. // Copyright 2013 The Go Authors. All rights reserved.
  2. //
  3. // Use of this source code is governed by a BSD-style
  4. // license that can be found in the LICENSE file or at
  5. // https://developers.google.com/open-source/licenses/bsd.
  6. // Package header provides functions for parsing HTTP headers.
  7. package header
  8. import (
  9. "net/http"
  10. "strings"
  11. "time"
  12. )
  13. // Octet types from RFC 2616.
  14. var octetTypes [256]octetType
  15. type octetType byte
  16. const (
  17. isToken octetType = 1 << iota
  18. isSpace
  19. )
  20. func init() {
  21. // OCTET = <any 8-bit sequence of data>
  22. // CHAR = <any US-ASCII character (octets 0 - 127)>
  23. // CTL = <any US-ASCII control character (octets 0 - 31) and DEL (127)>
  24. // CR = <US-ASCII CR, carriage return (13)>
  25. // LF = <US-ASCII LF, linefeed (10)>
  26. // SP = <US-ASCII SP, space (32)>
  27. // HT = <US-ASCII HT, horizontal-tab (9)>
  28. // <"> = <US-ASCII double-quote mark (34)>
  29. // CRLF = CR LF
  30. // LWS = [CRLF] 1*( SP | HT )
  31. // TEXT = <any OCTET except CTLs, but including LWS>
  32. // separators = "(" | ")" | "<" | ">" | "@" | "," | ";" | ":" | "\" | <">
  33. // | "/" | "[" | "]" | "?" | "=" | "{" | "}" | SP | HT
  34. // token = 1*<any CHAR except CTLs or separators>
  35. // qdtext = <any TEXT except <">>
  36. for c := 0; c < 256; c++ {
  37. var t octetType
  38. isCtl := c <= 31 || c == 127
  39. isChar := 0 <= c && c <= 127
  40. isSeparator := strings.IndexRune(" \t\"(),/:;<=>?@[]\\{}", rune(c)) >= 0
  41. if strings.IndexRune(" \t\r\n", rune(c)) >= 0 {
  42. t |= isSpace
  43. }
  44. if isChar && !isCtl && !isSeparator {
  45. t |= isToken
  46. }
  47. octetTypes[c] = t
  48. }
  49. }
  50. // Copy returns a shallow copy of the header.
  51. func Copy(header http.Header) http.Header {
  52. h := make(http.Header)
  53. for k, vs := range header {
  54. h[k] = vs
  55. }
  56. return h
  57. }
  58. var timeLayouts = []string{"Mon, 02 Jan 2006 15:04:05 GMT", time.RFC850, time.ANSIC}
  59. // ParseTime parses the header as time. The zero value is returned if the
  60. // header is not present or there is an error parsing the
  61. // header.
  62. func ParseTime(header http.Header, key string) time.Time {
  63. if s := header.Get(key); s != "" {
  64. for _, layout := range timeLayouts {
  65. if t, err := time.Parse(layout, s); err == nil {
  66. return t.UTC()
  67. }
  68. }
  69. }
  70. return time.Time{}
  71. }
  72. // ParseList parses a comma separated list of values. Commas are ignored in
  73. // quoted strings. Quoted values are not unescaped or unquoted. Whitespace is
  74. // trimmed.
  75. func ParseList(header http.Header, key string) []string {
  76. var result []string
  77. for _, s := range header[http.CanonicalHeaderKey(key)] {
  78. begin := 0
  79. end := 0
  80. escape := false
  81. quote := false
  82. for i := 0; i < len(s); i++ {
  83. b := s[i]
  84. switch {
  85. case escape:
  86. escape = false
  87. end = i + 1
  88. case quote:
  89. switch b {
  90. case '\\':
  91. escape = true
  92. case '"':
  93. quote = false
  94. }
  95. end = i + 1
  96. case b == '"':
  97. quote = true
  98. end = i + 1
  99. case octetTypes[b]&isSpace != 0:
  100. if begin == end {
  101. begin = i + 1
  102. end = begin
  103. }
  104. case b == ',':
  105. if begin < end {
  106. result = append(result, s[begin:end])
  107. }
  108. begin = i + 1
  109. end = begin
  110. default:
  111. end = i + 1
  112. }
  113. }
  114. if begin < end {
  115. result = append(result, s[begin:end])
  116. }
  117. }
  118. return result
  119. }
  120. // ParseValueAndParams parses a comma separated list of values with optional
  121. // semicolon separated name-value pairs. Content-Type and Content-Disposition
  122. // headers are in this format.
  123. func ParseValueAndParams(header http.Header, key string) (value string, params map[string]string) {
  124. params = make(map[string]string)
  125. s := header.Get(key)
  126. value, s = expectTokenSlash(s)
  127. if value == "" {
  128. return
  129. }
  130. value = strings.ToLower(value)
  131. s = skipSpace(s)
  132. for strings.HasPrefix(s, ";") {
  133. var pkey string
  134. pkey, s = expectToken(skipSpace(s[1:]))
  135. if pkey == "" {
  136. return
  137. }
  138. if !strings.HasPrefix(s, "=") {
  139. return
  140. }
  141. var pvalue string
  142. pvalue, s = expectTokenOrQuoted(s[1:])
  143. if pvalue == "" {
  144. return
  145. }
  146. pkey = strings.ToLower(pkey)
  147. params[pkey] = pvalue
  148. s = skipSpace(s)
  149. }
  150. return
  151. }
  152. // AcceptSpec describes an Accept* header.
  153. type AcceptSpec struct {
  154. Value string
  155. Q float64
  156. }
  157. // ParseAccept parses Accept* headers.
  158. func ParseAccept(header http.Header, key string) (specs []AcceptSpec) {
  159. loop:
  160. for _, s := range header[key] {
  161. for {
  162. var spec AcceptSpec
  163. spec.Value, s = expectTokenSlash(s)
  164. if spec.Value == "" {
  165. continue loop
  166. }
  167. spec.Q = 1.0
  168. s = skipSpace(s)
  169. if strings.HasPrefix(s, ";") {
  170. s = skipSpace(s[1:])
  171. if !strings.HasPrefix(s, "q=") {
  172. continue loop
  173. }
  174. spec.Q, s = expectQuality(s[2:])
  175. if spec.Q < 0.0 {
  176. continue loop
  177. }
  178. }
  179. specs = append(specs, spec)
  180. s = skipSpace(s)
  181. if !strings.HasPrefix(s, ",") {
  182. continue loop
  183. }
  184. s = skipSpace(s[1:])
  185. }
  186. }
  187. return
  188. }
  189. func skipSpace(s string) (rest string) {
  190. i := 0
  191. for ; i < len(s); i++ {
  192. if octetTypes[s[i]]&isSpace == 0 {
  193. break
  194. }
  195. }
  196. return s[i:]
  197. }
  198. func expectToken(s string) (token, rest string) {
  199. i := 0
  200. for ; i < len(s); i++ {
  201. if octetTypes[s[i]]&isToken == 0 {
  202. break
  203. }
  204. }
  205. return s[:i], s[i:]
  206. }
  207. func expectTokenSlash(s string) (token, rest string) {
  208. i := 0
  209. for ; i < len(s); i++ {
  210. b := s[i]
  211. if (octetTypes[b]&isToken == 0) && b != '/' {
  212. break
  213. }
  214. }
  215. return s[:i], s[i:]
  216. }
  217. func expectQuality(s string) (q float64, rest string) {
  218. switch {
  219. case len(s) == 0:
  220. return -1, ""
  221. case s[0] == '0':
  222. q = 0
  223. case s[0] == '1':
  224. q = 1
  225. default:
  226. return -1, ""
  227. }
  228. s = s[1:]
  229. if !strings.HasPrefix(s, ".") {
  230. return q, s
  231. }
  232. s = s[1:]
  233. i := 0
  234. n := 0
  235. d := 1
  236. for ; i < len(s); i++ {
  237. b := s[i]
  238. if b < '0' || b > '9' {
  239. break
  240. }
  241. n = n*10 + int(b) - '0'
  242. d *= 10
  243. }
  244. return q + float64(n)/float64(d), s[i:]
  245. }
  246. func expectTokenOrQuoted(s string) (value string, rest string) {
  247. if !strings.HasPrefix(s, "\"") {
  248. return expectToken(s)
  249. }
  250. s = s[1:]
  251. for i := 0; i < len(s); i++ {
  252. switch s[i] {
  253. case '"':
  254. return s[:i], s[i+1:]
  255. case '\\':
  256. p := make([]byte, len(s)-1)
  257. j := copy(p, s[:i])
  258. escape := true
  259. for i = i + 1; i < len(s); i++ {
  260. b := s[i]
  261. switch {
  262. case escape:
  263. escape = false
  264. p[j] = b
  265. j++
  266. case b == '\\':
  267. escape = true
  268. case b == '"':
  269. return string(p[:j]), s[i+1:]
  270. default:
  271. p[j] = b
  272. j++
  273. }
  274. }
  275. return "", ""
  276. }
  277. }
  278. return "", ""
  279. }