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 对象,控制台打印如下:
Golang: 接收GET和POST参数

三、处理 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);
});

访问页面,浏览器控制台打印结果如下:
Golang: 接收GET和POST参数

相关推荐