Go 请求和响应--处理请求

前面我们分析了http包中如何根据请求的URL转发请求到对应的处理器处理的，现在我们深入理解处理器是如何解析、处理请求的。

主要内容

• Request结构
• 表单
• 文本处理

1.1 Request结构

Request结构是根据HTTP请求报文，并按实际情况定义的，除了HTTP请求报文中定义的概念外，还增加了Form字段等信息。以下是Request结构的定义：

type Request struct {
    Method string     // 请求的方法
    URL *url.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
}

1.2 URL结构

Request中有个比较重要的字段URL，表示请求行中的URL，定义如下：

type URL struct {
    Scheme     string   // 方案
    Opaque     string    // 
    User       *Userinfo // 基本验证方式中的username和password信息
    Host       string    // 主机字段
    Path       string    // 路径
    RawPath    string    // 
    ForceQuery bool      // 
    RawQuery   string    // 查询字段
    Fragment   string    // 分片字段
}

1.3 请求首部

请求和响应的首部都使用Header类型表示，header类型是一个映射(map)类型，表示HTTP首部中多个键值对。

type Header map[string][]string

1.4 请求主体

请求和响应的主体都由Request结构中的Body表示，这个字段是Reader和Closer接口的结合。

我们尝试一下对Request结构的使用：

package main

import (
    "fmt"
    "net/http"
)

func urlHandler(w http.ResponseWriter, r *http.Request) {
    // Request中的URL结构
    fmt.Fprintln(w, r.URL.Path)
}

func headerHandler(w http.ResponseWriter, r *http.Request) {
    // Request结构中的Header是映射（map）类型，可以通过键值对进行操作，也可以使用map实现的Get, Set等方法操作。
    fmt.Fprintln(w, r.Header)
    fmt.Fprintln(w, r.Header.Get("Accept-Encoding"))
}

func bodyHandler(w http.ResponseWriter, r *http.Request) {
    // Request结构中的body字段实现了Reader接口，所以可以使用Read方法。
    len := r.ContentLength
    body := make([]byte, len)
    r.Body.Read(body)
    fmt.Fprintln(w, string(body))
}

func main() {
    http.HandleFunc("/url", urlHandler)
    http.HandleFunc("/header", headerHandler)
    http.HandleFunc("/body", bodyHandler)

    err := http.ListenAndServe(":8000", nil)
    if err != nil {
        fmt.Println(err)
    }
}

2.1 HTML表单

表单是客户端和服务端进行数据交互的载体。通常，表单由POST请求在请求体中传递的；当然也可以用GET请求传递，但是该表单数据将会在URL中也键值对的方式传递。
表单是一个包含表单元素的区域，表单元素（文本，下拉列表，单选框，文件等），Go中Request结构定义了Form字段，可以方便对表单进行操作。

    用户名:
    密码:
    

package main

import (
    "fmt"
    "html/template"
    "net/http"
)

func login(w http.ResponseWriter, r *http.Request) {
    // 登录逻辑，GET方法时放回登录页面，POST解析用户、密码进行登录验证。
    r.ParseForm() // 解析url传递的参数，对于POST请求则解析请求体（request body）
    if r.Method == "POST" {
        fmt.Println(r.Form["username"])
        fmt.Println(r.Form["password"])
    } else {
        t, _ := template.ParseFiles("login.html")
        t.Execute(w, nil)
    }
}

func main() {
    http.HandleFunc("/login", login)

    err := http.ListenAndServe(":8000", nil)
    if err != nil {
        fmt.Println(err)
    }
}

2.2 文件

Web用户经常会使用文件上传功能，比如上传头像图片等。我们来实现文件上传功能。
首先我们先了解一下form的enctype属性，它决定了请求时在发送键值对将会使用的格式。enctype的三种格式：

格式	说明
application/x-www-form-urlencoded	form的默认值，使用此格式的时候，表单中的数据被编码成一个连续的“长查询字符串”,不同的键值对将使用&符号隔开，而键值之间使用等号(=)隔开。这种形式是跟URL编码一样的。如：username=admin&password=123
multipart/form-data	将数据编码成MIME报文，表单中的每个键值对都带有各自的内容类型和内容配置（disposition）
text/plain	空格转换为 "+" 加号，但不对特殊字符编码。

multipart/form-data格式常用于文件上传功能，所以我们以这种格式来示范文件上传功能。

package main

import (
    "fmt"
    "html/template"
    "io"
    "net/http"
    "os"
)

func upload(w http.ResponseWriter, r *http.Request) {
    if r.Method == "POST" {
        //
        r.ParseMultipartForm(1024)
        // 使用r.FormFile获取文件句柄，然后对文件进行存储等处理。
        file, handler, err := r.FormFile("uploadfile")
        defer file.Close()

        if err != nil {
            fmt.Println(err)
            return
        }

        fmt.Fprintf(w, "%v", handler.Header)

        // 假设已经有upload目录，存储文件。
        f, err := os.OpenFile("../static/upload/"+handler.Filename, os.O_WRONLY|os.O_CREATE, 0666)
        if err != nil {
            fmt.Println(err)
            return
        }
        defer f.Close()
        io.Copy(f, file)
    } else {
        t, _ := template.ParseFiles("upload.html")
        t.Execute(w, nil)
    }

}

func main() {
    http.HandleFunc("/upload", upload)
    err := http.ListenAndServe(":8000", nil)
    if err != nil {
        fmt.Println(err)
    }
}

本节详细说明了Go中的Request结构，以及结合表单的使用。接下来介绍cookie与session的使用。

代码传送门