Golang: 接收GET和POST参数

GET 和 POST 是我们最常用的两种请求方式，今天结合前端 axios 请求库来讲一讲，如何在 golang 服务中，正确接收这两种请求的参数信息。

一、搭建一个简单的服务

首先，我们来创建一个最简单的静态页面，将 axios 引进来：

<!DOCTYPE html>

<html>

  <head>

    <script src="https://unpkg.com/axios/dist/axios.min.js"></script>

  </head>

  <body>

    GET & POST

  </body>

</html>

接下来，我们写一个简单的 golang 服务程序，在浏览器端访问这个服务时，将上面的静态页面内容返回给浏览器：

package main

import (

    "log"

    "fmt"

    "net/http"

    "html/template"

)

// 返回静态页面

func handleIndex(writer http.ResponseWriter, request *http.Request) {

    t, _ := template.ParseFiles("index.html")

    t.Execute(writer, nil)

}

func main() {

    http.HandleFunc("/", handleIndex)

    fmt.Println("Running at port 3000 ...")

    err := http.ListenAndServe(":3000", nil)

    if err != nil {

        log.Fatal("ListenAndServe: ", err.Error())

    }

}

运行上面程序，然后在浏览器中访问 localhost:3000，就可以看到一个简单的静态页面了。

二、处理 GET 请求

接下来，我们就在静态页面中添加一个 GET 请求：

<script>

  axios.get('/testGet', {

    params: {

      id: 1,

    }

  }).then((response) => {

    console.log(response);

  });

</script>

对应地，服务端也要添加这个请求路径的处理函数：

// 处理GET请求

func handleGet(writer http.ResponseWriter, request *http.Request) {

    query := request.URL.Query()

    // 第一种方式

    // id := query["id"][0]

    // 第二种方式

    id := query.Get("id")

    fmt.Printf("GET: id=%s\n", id)

    fmt.Fprintf(writer, `{"code":0}`)

}

func main() {

    // ...

    http.HandleFunc("/testGet", handleGet)

    // ...

}

重新运行程序，访问页面，服务端控制台打印如下：

GET: id=1

在接收到请求参数后，我们会返回一个 {"code":0} 的响应结果，浏览器端收到响应后，会将其转为 JS 对象，控制台打印如下：

三、处理 POST 请求

在开发中，常用的 POST 请求有两种，分别是 application/json 和 application/x-www-form-urlencoded，下面就来介绍一下这两种类型的处理方式。

先说第一种，在使用 axios 发起请求时，默认就是 application/json 类型，我们来添加一个这样的请求：

// POST数据

const postData = {

  username: 'admin',

  password: '123',

};

axios.post('/testPostJson', postData).then((response) => {

  console.log(response);

});

同样地，我们需要在 golang 服务中添加处理函数：

// 引入encoding/json包

import (

    // ...

    "encoding/json"

)

// 处理application/json类型的POST请求

func handlePostJson(writer http.ResponseWriter, request *http.Request) {

    // 根据请求body创建一个json解析器实例

    decoder := json.NewDecoder(request.Body)

    // 用于存放参数key=value数据

    var params map[string]string

    // 解析参数 存入map

    decoder.Decode(&params)

    fmt.Printf("POST json: username=%s, password=%s\n", params["username"], params["password"])

    fmt.Fprintf(writer, `{"code":0}`)

}

func main() {

    // ...

    http.HandleFunc("/testPostJson", handlePostJson)

    // ...

}

再次运行程序，访问页面，服务端控制台打印如下：

POST json: username=admin, password=123

如果我们使用 application/x-www-form-urlencoded 这样的请求类型，就需要在发送请求时，额外添加一些配置信息：

// POST数据

const postData = {

  username: 'admin',

  password: '123',

};

axios.post('/testPostForm', postData, {

  headers: {

    'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',

  },

  transformRequest: [(data) => {

    const pairs = [];

    Object.keys(data).forEach(key => {

      pairs.push(`${key}=${data[key]}`);

    });

    return pairs.join('&');

  }]

}).then((response) => {

  console.log(response);

});

对应的服务端 golang 处理函数如下：

// 处理application/x-www-form-urlencoded类型的POST请求

func handlePostForm(writer http.ResponseWriter, request *http.Request) {

    request.ParseForm()

    // 第一种方式

    // username := request.Form["username"][0]

    // password := request.Form["password"][0]

    // 第二种方式

    username := request.Form.Get("username")

    password := request.Form.Get("password")

    fmt.Printf("POST form-urlencoded: username=%s, password=%s\n", username, password)

    fmt.Fprintf(writer, `{"code":0}`)

}

func main() {

    // ...

    http.HandleFunc("/testPostForm", handlePostForm)

    // ...

}

最后运行程序并访问，服务端控制台打印如下：

POST form-urlencoded: username=admin, password=123

四、返回JSON对象数据

前面我们的处理函数中，都返回了一个简单的 JSON 字符串，实际开发中，往往是一些数据对象，我们需要将这些数据对象以 JSON 的形式返回，下面我们就来添加一段代码：

type Person struct {

    Name string `json:"name"`

    Age int `json:"age"`

}

type Response struct {

    Code int `json:"code"`

    Msg string `json:"msg"`

    Data Person `json:"data"`

}

// 返回数据对象的JSON数据

func handleResponseJson(writer http.ResponseWriter, request *http.Request) {

    res := Response{

        0,

        "success",

        Person{

            "Jack",

            20,

        },

    }

    json.NewEncoder(writer).Encode(res)

}

func main() {

    // ...

    http.HandleFunc("/handleResponseJson", handleResponseJson)

    // ...

}

接着，我们使用 axios 测试一下这个服务：

axios.get('/handleResponseJson').then((response) => {

  console.log(response);

});

访问页面，浏览器控制台打印结果如下：