之前这个系列的文章一直在讲用Go语言怎么编写HTTP服务器来提供服务，如何给服务器配置路由来匹配请求到对应的处理程序，如何添加中间件把一些通用的处理任务从具体的Handler中解耦出来，以及如何更规范地在项目中应用数据库。不过一直漏掉了一个环节是服务器接收到请求后如何解析请求拿到想要的数据，Go语言使用net/http包中的Request结构体对象来表示HTTP请求，通过Request结构对象上定义的方法和数据字段，应用程序能够便捷地访问和设置HTTP请求中的数据。
一般服务端解析请求的需求有如下几种
- HTTP请求头中的字段值
- URL 查询字符串中的字段值
- 请求体中的
Form表单数据 - 请求体中的
JSON格式数据 - 读取客户端的上传的文件
今天这篇文章我们就按照这几种常见的服务端对HTTP请求的操作来说一下服务器应用程序如何通过Request对象解析请求头和请求体。
Request 结构定义
在说具体操作的使用方法之前我们先来看看net/http包中Request结构体的定义，了解一下Request拥有什么样的数据结构。Request结构在源码中的定义如下。
type Request struct {
Method string
URL *url.URL
Proto string // "HTTP/1.0"
ProtoMajor int // 1
ProtoMinor int // 0
Header Header
Body io.ReadCloser
GetBody func() (io.ReadCloser, error)
ContentLength int64
TransferEncoding []string
Close bool
Host string
Form url.Values
PostForm url.Values
MultipartForm *multipart.Form
Trailer Header
RemoteAddr string
RequestURI string
TLS *tls.ConnectionState
Cancel <-chan struct{}
Response *Response
ctx context.Context
}
复制代码我们快速地了解一下每个字段大致的含义，了解了每个字段的含义在不同的应用场景下需要读取访问HTTP请求的不同部分时就能够有的放矢了。
Method
指定HTTP方法（GET，POST，PUT等）。
URL
URL指定要请求的URI（对于服务器请求）或要访问的URL（用于客户请求）。它是一个表示URL的类型url.URL的指针，url.URL的结构定义如下：
type URL struct {
Scheme string
Opaque string
User *Useri
Host string
Path string
RawPath string
ForceQuery bool
RawQuery string
Fragment string
}
复制代码Proto
Proto，ProtoMajor，ProtoMinor三个字段表示传入服务器请求的协议版本。对于客户请求，这些字段将被忽略。 HTTP客户端代码始终使用HTTP / 1.1或HTTP / 2。
Header
Header包含服务端收到或者由客户端发送的HTTP请求头，该字段是一个http.Header类型的指针，http.Header类型的声明如下：
type Header map[string][]string
复制代码是map[string][]string类型的别名，http.Header类型实现了GET，SET，Add等方法用于存取请求头。如果服务端收到带有如下请求头的请求：
Host: example.com
accept-encoding: gzip, deflate
Accept-Language: en-us
fOO: Bar
foo: two
复制代码那么Header的值为：
Header = map[string][]string{
"Accept-Encoding": {"gzip, deflate"},
"Accept-Language": {"en-us"},
"Foo": {"Bar", "two"},
}
复制代码对于传入的请求，Host标头被提升为Request.Host字段，并将其从Header对象中删除。HTTP 定义头部的名称是不区分大小写的。Go使用CanonicalHeaderKey实现的请求解析器使得请求头名称第一个字母以及跟随在短横线后的第一个字母大写其他都为小写形式，比如：Content-Length。对于客户端请求，某些标头，例如Content-Length和Connection会在需要时自动写入，并且标头中的值可能会被忽略。
Body
这个字段的类型是io.ReadCloser，Body是请求的主体。对于客户端发出的请求，nil主体表示该请求没有Body，例如GET请求。 HTTP客户端的传输会负责调用Close方法。对于服务器接收的请求，请求主体始终为非nil，但如果请求没有主体，则将立即返回EOF。服务器将自动关闭请求主体。服务器端的处理程序不需要关心此操作。
GetBody
客户端使用的方法的类型，其声明为：
GetBody func() (io.ReadCloser, error)
复制代码ContentLength
ContentLength记录请求关联内容的长度。值-1表示长度未知。值>=0表示从Body 中读取到的字节数。对于客户请求，值为0且非nil的Body也会被视为长度未知。
####TransferEncoding
TransferEncoding为字符串切片，其中会列出从最外层到最内层的传输编码，TransferEncoding通常可以忽略；在发送和接收请求时，分块编码会在需要时自动被添加或者删除。
Close
Close表示在服务端回复请求或者客户端读取到响应后是否要关闭连接。对于服务器请求，HTTP服务器会自动处理
并且处理程序不需要此字段。对于客户请求，设置此字段为true可防止重复使用到相同主机的请求之间的TCP连接，就像已设置Transport.DisableKeepAlives一样。
Host
对于服务器请求，Host指定URL所在的主机，为防止DNS重新绑定攻击，服务器处理程序应验证Host标头具有的值。
http库中的ServeMux（复用器）支持注册到特定Host的模式，从而保护其注册的处理程序。对于客户端请求，Host可以用来选择性地覆盖请求头中的Host，如果不设置，Request.Write使用URL.Host来设置请求头中的Host。
Form
Form包含已解析的表单数据，包括URL字段的查询参数以及PATCH，POST或PUT表单数据。此字段仅在调用Request.ParseForm之后可用。HTTP客户端会忽略Form并改用Body。Form字段的类型是url.Values类型的指针。url.Values类型的声明如下：
type Values map[string][]string
复制代码也是map[string][]string类型的别名。url.Values类型实现了GET，SET，Add，Del等方法用于存取表单数据。
PostForm
PostForm类型与Form字段一样，包含来自PATCH，POST的已解析表单数据或PUT主体参数。此字段仅在调用ParseForm之后可用。HTTP客户端会忽略PostForm并改用Body。
####MultipartForm
MultipartForm是已解析的多部分表单数据，包括文件上传。仅在调用Request.ParseMultipartForm之后，此字段才可用。HTTP客户端会忽略MultipartForm并改用Body。该字段的类型是*multipart.Form。
RemoteAddr
RemoteAddr允许HTTP服务器和其他软件记录发送请求的网络地址，通常用于记录。 net/http包中的HTTP服务器在调用处理程序之前将RemoteAddr设置为“ IP：端口”， HTTP客户端会忽略此字段。
RequestURI
RequestURI是未修改的request-target客户端发送的请求行（RFC 7230，第3.1.1节）。在服务器端，通常应改用URL字段。在HTTP客户端请求中设置此字段是错误的。
Response
Response字段类型为*Response，它指定了导致此请求被创建的重定向响应，此字段仅在客户端发生重定向时被填充。
ctx
ctx 是客户端上下文或服务器上下文。它应该只通过使用WithContext复制整个Request进行修改。这个字段未导出以防止人们错误使用Context并更改同一请求的调用方所拥有的上下文。
读取请求头
上面分析了Go将HTTP请求头存储在Request结构体对象的Header字段里，Header字段实质上是一个Map，请求头的名称为Mapkey，Map Value的类型为字符串切片，有的请求头像Accept会有多个值，在切片中就对应多个元素。
Header类型的Get方法可以获取请求头的第一个值，
func exampleHandler(w http.ResponseWriter, r *http.Request) {
ua := r.Header.Get("User-Agent")
...
}
复制代码或者是获取值时直接通过key获取对应的切片值就好，比如将上面的改为：
ua := r.Header["User-Agent"]
复制代码下面我们写个遍历请求头信息的示例程序，同时也会通上面介绍的Request结构中定义的Method，URL，Host，RemoteAddr等字段把请求的通用信息打印出来。在我们一直使用的http_demo项目中增加一个DisplayHeadersHandler，其源码如下：
package handler
import (
"fmt"
"net/http"
)
func DisplayHeadersHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Method: %s URL: %s Protocol: %s \n", r.Method, r.URL, r.Proto)
// 遍历所有请求头
for k, v := range r.Header {
fmt.Fprintf(w, "Header field %q, Value %q\n", k, v)
}
fmt.Fprintf(w, "Host = %q\n", r.Host)
fmt.Fprintf(w, "RemoteAddr= %q\n", r.RemoteAddr)
// 通过 Key 获取指定请求头的值
fmt.Fprintf(w, "\n\nFinding value of \"Accept\" %q", r.Header["Accept"])
}
复制代码将其处理程序绑定到/index/display_headers路由上：
indexRouter.HandleFunc("/display_headers", handler.DisplayHeadersHandler)
复制代码然后启动项目，打开浏览器访问:
http://localhost:8000/index/display_headers
复制代码可以看到如下输出：
http_demo项目中已经添加了本文中所有示例的源码，关注文末公众号回复gohttp06可以获取源码的下载链接。
获取URL参数值
GET请求中的URL查询字符串中的参数可以通过url.Query()，我们来看一下啊url.Query()函数的源码：
func (u *URL) Query() Values {
v, _ := ParseQuery(u.RawQuery)
return v
}
复制代码它通过ParseQuery函数解析URL参数然后返回一个url.Values类型的值。url.Values类型上面我们已经介绍过了是map[string][]string类型的别名，实现了GET，SET，Add，Del等方法用于存取数据。
所以我们可以使用r.URL.Query().Get("ParamName")获取参数值，也可以使用r.URL.Query()["ParamName"]。两者的区别是Get只返回切片中的第一个值，如果参数对应多个值时（比如复选框表单那种请求就是一个name对应多个值），记住要使用第二种方式。
我们通过运行一个示例程序display_url_params.go来看一下两种获取URL参数的区别
package handler
import (
"fmt"
"net/http"
)
func DisplayUrlParamsHandler(w http.ResponseWriter, r *http.Request) {
for k, v := range r.URL.Query() {
fmt.Fprintf(w, "ParamName %q, Value %q\n", k, v)
fmt.Fprintf(w, "ParamName %q, Get Value %q\n", k, r.URL.Query().Get(k))
}
}
复制代码将其处理程序绑定到/index/display_url_params路由上：
indexRouter.HandleFunc("/display_url_params", handler.DisplayUrlParamsHandler)
复制代码打开浏览器访问
http://localhost:8000/index/display_url_params?a=b&c=d&a=c
复制代码浏览器会输出：
ParamName "a", Value ["b" "c"]
ParamName "a", Get Value "b"
ParamName "c", Value ["d"]
ParamName "c", Get Value "d"
复制代码我们为参数a传递了两个参数值，可以看到通过url.Query.Get()只能读取到第一个参数值。
获取表单中的参数值
Request结构的Form字段包含已解析的表单数据，包括URL字段的查询参数以及PATCH，POST或PUT表单数据。此字段仅在调用Request.ParseForm之后可用。不过Request对象提供一个FormValue方法来获取指定名称的表单数据，FormValue方法会根据Form字段是否有设置来自动执行ParseForm方法。
func (r *Request) FormValue(key string) string {
if r.Form == nil {
r.ParseMultipartForm(defaultMaxMemory)
}
if vs := r.Form[key]; len(vs) > 0 {
return vs[0]
}
return ""
}
复制代码可以看到FormValue方法也是只返回切片中的第一个值。如果需要获取字段对应的所有值，那么需要通过字段名访问Form字段。如下：
获取表单字段的单个值
r.FormValue(key)
复制代码获取表单字段的多个值
r.ParseForm()
r.Form["key"]
复制代码下面是我们的示例程序，以及对应的路由：
//handler/display_form_data.go
package handler
import (
"fmt"
"net/http"
)
func DisplayFormDataHandler(w http.ResponseWriter, r *http.Request) {
if err := r.ParseForm(); err != nil {
panic(err)
}
for key, values := range r.Form {
fmt.Fprintf(w, "Form field %q, Values %q\n", key, values)
fmt.Fprintf(w, "Form field %q, Value %q\n", key, r.FormValue(key))
}
}
//router.go
indexRouter.HandleFunc("/display_form_data", handler.DisplayFormDataHandler)
复制代码我们在命令行中使用cURL命令发送表单数据到处理程序，看看效果。
curl -X POST -d 'username=James&password=123' \
http://localhost:8000/index/display_form_data
复制代码返回的响应如下：
Form field "username", Values ["James"]
Form field "username", Value "James"
Form field "password", Values ["123"]
Form field "password", Value "123"
复制代码获取 Cookie
Request对象专门提供了一个Cookie方法用来访问请求中携带的Cookie数据，方法会返回一个*Cookie类型的值以及error。Cookie类型的定义如下：
type Cookie struct {
Name string
Value string
Path string // optional
Domain string // optional
Expires time.Time // optional
RawExpires string // for reading cookies only
MaxAge int
Secure bool
HttpOnly bool
SameSite SameSite
Raw string
Unparsed []string
}
复制代码所以要读取请求中指定名称的Cookie值，只需要
cookie, err := r.Cookie(name)
// 错误检查
...
value := cookie.Value
复制代码Request.Cookies()方法会返回[]*Cookie切片，其中会包含请求中所有的Cookie
下面的示例程序，会打印请求中所有的Cookie
// handler/read_cookie.go
package handler
import (
"fmt"
"net/http"
)
func ReadCookieHandler(w http.ResponseWriter, r *http.Request) {
for _, cookie := range r.Cookies() {
fmt.Fprintf(w, "Cookie field %q, Value %q\n", cookie.Name, cookie.Value)
}
}
//router/router.go
indexRouter.HandleFunc("/read_cookie", handler.ReadCookieHandler)
复制代码我们通过cURL在命令行请求http://localhost:8000/index/read_cookie
curl --cookie "USER_TOKEN=Yes" http://localhost:8000/index/read_cookie
复制代码执行命令后会返回：
Cookie field "USER_TOKEN", Value "Yes"
复制代码解析请求体中的JSON数据
现在前端都倾向于把请求数据以JSON格式放到请求主体中传给服务器，针对这个使用场景，我们需要把请求体作为json.NewDecoder()的输入流，然后将请求体中携带的JSON格式的数据解析到声明的结构体变量中
//handler/parse_json_request
package handler
import (
"encoding/json"
"fmt"
"net/http"
)
type Person struct {
Name string
Age int
}
func DisplayPersonHandler(w http.ResponseWriter, r *http.Request) {
var p Person
// 将请求体中的 JSON 数据解析到结构体中
// 发生错误，返回400 错误码
err := json.NewDecoder(r.Body).Decode(&p)
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
fmt.Fprintf(w, "Person: %+v", p)
}
// router/router.go
indexRouter.HandleFunc("/parse_json_request", handler.ParseJsonRequestHandler)
复制代码在命令行里用cURL命令测试我们的程序：
curl -X POST -d '{"name": "James", "age": 18}' \
-H "Content-Type: application/json" \
http://localhost:8000/index/parse_json_request
复制代码返回响应如下：
Person: {Name:James Age:18}%
复制代码读取上传文件
服务器接收客户端上传的文件，使用Request定义的FormFile()方法。该方法会自动调用r.ParseMultipartForm(32 << 20)方法解析请求多部表单中的上传文件，并把文件可读入内存的大小设置为32M（32向左位移20位），如果内存大小需要单独设置，就要在程序里单独调用ParseMultipartForm()方法才行。
func ReceiveFile(w http.ResponseWriter, r *http.Request) {
r.ParseMultipartForm(32 << 20)
var buf bytes.Buffer
file, header, err := r.FormFile("file")
if err != nil {
panic(err)
}
defer file.Close()
name := strings.Split(header.Filename, ".")
fmt.Printf("File name %s\n", name[0])
io.Copy(&buf, file)
contents := buf.String()
fmt.Println(contents)
buf.Reset()
return
}
复制代码Go语言解析HTTP请求比较常用的方法我们都介绍的差不多了。因为想总结全一点，篇幅还是有点长，不过整体不难懂，而且也可以下载程序中的源码自己运行调试，动手实践一下更有助于理解吸收。HTTP客户端发送请求要设置的内容也只今天讲的Request结构体的字段，Request对象也提供了一些设置相关的方法供开发人员使用，今天就先说这么多了。
关注下方公众号回复gohttp06可以下载文章中项目的源码，赶快下载下来自己试一试吧。
前文回顾
有疑问加站长微信联系（非本文作者）
