Golang Web开发之Gin的请求参数处理

在一个API的请求中，通常需要获取到请求参数，对请求参数做处理，实现业务逻辑。

在这里，将为您介绍3种类型的请求参数的获取方式。

1. URL路径参数处理

// Param returns the value of the URL param.
// It is a shortcut for c.Params.ByName(key)
//     router.GET("/user/:id", func(c *gin.Context) {
//         // a GET request to /user/john
//         id := c.Param("id") // id == "john"
//     })
func (c *Context) Param(key string) string {
    return c.Params.ByName(key)
}

package main


import (
    "github.com/gin-gonic/gin"
    "net/http"
)


func main() {
    r := gin.Default()


    // 获取 /user/:id 这类型路由绑定的参数
    r.GET("/user/:id", func(c *gin.Context) {
        // 获取url参数id
        id := c.Param("id")


        c.String(http.StatusOK, "%s的信息", id)
    })


    r.Run()
}

[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.


[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:   export GIN_MODE=release
 - using code:  gin.SetMode(gin.ReleaseMode)


[GIN-debug] GET    /user/:id                 --> main.main.func1 (3 handlers)
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080
[GIN] 2021/10/13 - 14:36:54 | 200 |            0s |       127.0.0.1 | GET      "/user/zhangsan_id"

// Query returns the keyed url query value if it exists,
// otherwise it returns an empty string `("")`.
// It is shortcut for `c.Request.URL.Query().Get(key)`
//     GET /path?id=1234&name=Manu&value=
//     c.Query("id") == "1234"
//     c.Query("name") == "Manu"
//     c.Query("value") == ""
//     c.Query("wtf") == ""
func (c *Context) Query(key string) (value string) {
    value, _ = c.GetQuery(key)
    return
}

// DefaultQuery returns the keyed url query value if it exists,
// otherwise it returns the specified defaultValue string.
// See: Query() and GetQuery() for further information.
//     GET /?name=Manu&lastname=
//     c.DefaultQuery("name", "unknown") == "Manu"
//     c.DefaultQuery("id", "none") == "none"
//     c.DefaultQuery("lastname", "none") == ""
func (c *Context) DefaultQuery(key, defaultValue string) string {
    if value, ok := c.GetQuery(key); ok {
        return value
    }
    return defaultValue
}

// GetQuery is like Query(), it returns the keyed url query value
// if it exists `(value, true)` (even when the value is an empty string),
// otherwise it returns `("", false)`.
// It is shortcut for `c.Request.URL.Query().Get(key)`
//     GET /?name=Manu&lastname=
//     ("Manu", true) == c.GetQuery("name")
//     ("", false) == c.GetQuery("id")
//     ("", true) == c.GetQuery("lastname")
func (c *Context) GetQuery(key string) (string, bool) {
    if values, ok := c.GetQueryArray(key); ok {
        return values[0], ok
    }
    return "", false
}

package main


import (
    "github.com/gin-gonic/gin"
    "net/http"
    "fmt"
)


func main() {
  r := gin.Default()


  r.GET("/user", testGetParamHandler)


  r.Run()
}


func testGetParamHandler(c *gin.Context) {


  // 获取请求参数的三种方式：


  // 方式一：Query函数
  name := c.Query("name")
  fmt.Println("方式一：", name)


  // 方式二：DefaultQuery函数
  // 可以通过第二个参数设置默认值。
  name = c.DefaultQuery("name", "sirxy")
  fmt.Println("方式二：", name)


  // 方式三：GetQuery函数，
  // 它返回两个参数，第一个是参数值，
  // 第二个参数是参数是否存在的bool值，可以用来判断参数是否存在。
  name, ok := c.GetQuery("name")
  if !ok {
    // 参数不存在逻辑
  }
  fmt.Println("方式三：", name)


  // 其他业务逻辑


  // 返回结果
  c.JSON(http.StatusOK, gin.H{
    "name": name,
  })
}

[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.
[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:   export GIN_MODE=release
 - using code:  gin.SetMode(gin.ReleaseMode)
[GIN-debug] GET    /user                     --> main.testGetParamHandler (3 handlers)
[GIN-debug] Environment variable PORT is undefined. Using port :8080 by default
[GIN-debug] Listening and serving HTTP on :8080
方式一：lisi
方式二：lisi
方式三：lisi
[GIN] 2021/10/13 - 15:04:08 | 200 |       516.7µs |       127.0.0.1 | GET      "/user?name=lisi"

3. POST请求参数处理

同样地，在Gin中，可以通过下面这3个常用函数，获取POST请求参数。

总结

本文介绍了，在Gin中是如何处理各类请求参数的，也给出了它们的处理API源码，并对各种方式做了一个简单阐述与演示。

后续，我将为您逐步介绍Gin的一些其他教程，敬请期待~~。