1. 获取QueryString参数

QueryString 参数指的是URL中 ? 后面携带的参数，是 key-value 结构，例如：/user/search?username=小王子&address=沙河。顾名思义，query为查询之意，因此常与GET请求相配。
获取QueryString的方法一般有两个：c.DefaultQuery(“…” string, “…” string ) 和 c.Query(“…” string )。其中，c.DefaultQuery 的第一个string参数为字段的key，第二参数为字段的默认值；而 c.Query 没有默认值，只需要传入key就行。
二者都是获取参数，因此必须要有个实例来接收参数，所以一般用类型推导=>
key := c.Query(“key”)
举个例子：

  1. func main() {
  2.     //Default返回一个默认的路由引擎
  3.     r := gin.Default()
  4.     r.GET("/user/search", func(c *gin.Context) {
  6.         username := c.DefaultQuery("username", "小王子")
  7.         //username := c.Query("username")
  8.         address := c.Query("address")
  10.         //输出json结果给调用方
  11.         c.JSON(http.StatusOK, gin.H{
  12.             "message":  "ok",
  13.             "username": username,
  14.             "address":  address,
  15.         })
  16.     })
  17.     r.Run()
  18. }

2. 获取form参数

  1. 当前端请求的数据通过form表单提交时，我们将该参数称作 form 参数，通常与**POST请求**相配。<br />获取form参数也有两个方法，c.DefaultPostForm 和 c.PostForm 前者有默认值、后者无默认值。
  1. func main() {
  2.     //Default返回一个默认的路由引擎
  3.     r := gin.Default()
  4.     r.POST("/user/search", func(c *gin.Context) {
  6.         // DefaultPostForm取不到值时会返回指定的默认值
  7.         username := c.DefaultPostForm("username", "小王子")
  8.         // username := c.PostForm("username")
  9.         address := c.PostForm("address")
  11.         //输出json结果给调用方
  12.         c.JSON(http.StatusOK, gin.H{
  13.             "message":  "ok",
  14.             "username": username,
  15.             "address":  address,
  16.         })
  17.     })
  18.     r.Run(":8080")
  19. }
  1. 上述代码测试结果：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/2643809/1619686927152-175c935d-6c6d-4e86-9d1b-8704cea5ef84.png#clientId=uc630d061-a51a-4&from=paste&height=554&id=u813f5b7c&margin=%5Bobject%20Object%5D&name=image.png&originHeight=554&originWidth=1187&originalType=binary&size=67335&status=done&style=none&taskId=ue6684c69-e369-44e9-b451-84d3c0fa0ca&width=1187)

3. 获取JSON参数

当前端请求的数据通过JSON提交时，我将该参数称作 JSON 参数，通常与POST请求相配。另外，JSON参数是与前端交互中使用的最多的参数格式。JSON格式的数据一般是一个map，原生来讲，用 GetRawData() 来接收，会返回一个data和一个error。
但是data是一条原生数据，我们看不懂，需要通过 json.Unmarshall (data, &m) 来反序列化，其中m为一个 map[string]interface{ } 型的map。发序列化之后，map就存储着json发来的数据：

  1. func main() {
  2.     //Default返回一个默认的路由引擎
  3.     r := gin.Default()
  4.     r.POST("/user/search", func(c *gin.Context) {
  6.         data,err := c.GetRawData()
  7.         var m map[string]interface{}
  8.         _ = json.Unmarshal(data,&m)
  10.         //输出json结果
  11.         c.JSON(http.StatusOK, gin.H{
  12.             "data": m,
  13.             "err":  err,
  14.         })
  15.     })
  16.     r.Run(":8080")
  17. }
  1. 测试结果：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/2643809/1619687859017-f64bc575-6e3f-448d-aa4b-62b4f3528f51.png#clientId=uc630d061-a51a-4&from=paste&height=574&id=u5194c3e2&margin=%5Bobject%20Object%5D&name=image.png&originHeight=574&originWidth=1186&originalType=binary&size=62302&status=done&style=none&taskId=ubba38df6-dbbd-47d9-8064-911d5a7b8de&width=1186)<br />不过一般不这样做，而是用后面将会介绍的，强大的 c.ShouldBind 方法

4. 获取URL参数

用于直接接收 URL 路径中包含的参数，如：/user/search/狗/阿拉斯加。由于不需要手动传参，所以通常与GET请求 相配。
在GET请求的URL里，需要用到的 字段key 前要用冒号 ‘ : ‘ 标注，可以标多个，但每个 /…/ 之间只能标一个。
使用的方法为：c.Param(“key”)，也需要实例来接收
举个例子：

  1. func main() {
  2.     //Default返回一个默认的路由引擎
  3.     r := gin.Default()
  4.     r.GET("/user/search/:username/:address", func(c *gin.Context) {
  6.         username:= c.Param("username")
  7.         address:= c.Param("address")
  9.         //输出json结果
  10.         c.JSON(http.StatusOK, gin.H{
  11.             "username": username,
  12.             "address":  address,
  13.         })
  14.     })
  15.     r.Run(":8080")
  16. }

测试结果：
image.png

5. 参数绑定与ShouldBind

为了能够更方便的获取请求中的相关参数，提高开发效率，我们可以基于 c.ShouldBind 识别请求的数据类型并利用反射机制自动提取请求中 QueryString、form表单、JSON、XML 等参数到 结构体 中。下面的示例代码将演示 c.ShouldBind(&…) 的强大功能，它能够基于请求 自动提取 JSON、form表单 和 QueryString 类型的数据，并把值绑定到指定的 结构体对象 中。

  1. func main() {
  2.     router := gin.Default()
  4.     // 绑定JSON的示例 ({"user": "q1mi", "password": "123456"})
  5.     router.POST("/loginJSON", func(c *gin.Context) {
  6.         var login Login
  7.         // ShouldBind()会根据请求的Content-Type自行选择绑定器
  8.         if err := c.ShouldBind(&login); err == nil {
  9.             c.JSON(http.StatusOK, gin.H{
  10.                 "login":login,
  11.             })
  12.         } else {
  13.             c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  14.         }
  16.     })
  18.     // 绑定form表单示例 (user=q1mi&password=123456)
  19.     router.POST("/loginForm", func(c *gin.Context) {
  20.         var login Login
  21.         // ShouldBind()会根据请求的Content-Type自行选择绑定器
  22.         if err := c.ShouldBind(&login); err == nil {
  23.             c.JSON(http.StatusOK, gin.H{
  24.                 "login":login,
  25.             })
  26.         } else {
  27.             c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  28.         }
  29.     })
  31.     // 绑定QueryString示例 (/loginQuery?user=q1mi&password=123456)
  32.     router.GET("/loginQuery", func(c *gin.Context) {
  33.         var login Login
  34.         // ShouldBind()会根据请求的Content-Type自行选择绑定器
  35.         if err := c.ShouldBind(&login); err == nil {
  36.             c.JSON(http.StatusOK, gin.H{
  37.                 "login":login,
  38.             })
  39.         } else {
  40.             c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
  41.         }
  42.     })
  44.     // Listen and serve on 0.0.0.0:8080
  45.     router.Run(":8080")
  46. }
  1. JSON测试：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/2643809/1619689190169-6c4c6ced-591f-4c0a-b156-e0e11eb8b8d0.png#clientId=uc630d061-a51a-4&from=paste&height=502&id=u600f57e9&margin=%5Bobject%20Object%5D&name=image.png&originHeight=502&originWidth=1174&originalType=binary&size=54459&status=done&style=none&taskId=uf1bf2112-5210-4db0-9c79-5772c570063&width=1174)<br />form表单测试：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/2643809/1619689264105-a983eccb-4507-4df6-baed-703c1ead848c.png#clientId=uc630d061-a51a-4&from=paste&height=508&id=u7e735384&margin=%5Bobject%20Object%5D&name=image.png&originHeight=508&originWidth=1185&originalType=binary&size=56318&status=done&style=none&taskId=u85302132-224f-4457-b2f9-777ac494b4d&width=1185)<br />QueryString测试：<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/2643809/1619689378266-ee96aa90-7ae6-45f4-877e-d090a2cfbdd7.png#clientId=uc630d061-a51a-4&from=paste&height=552&id=ua1e7561e&margin=%5Bobject%20Object%5D&name=image.png&originHeight=552&originWidth=1185&originalType=binary&size=59896&status=done&style=none&taskId=uc8b383cc-adda-42a0-89f4-bd06cd67fc8&width=1185)<br />因此只要遇到参数获取，不过是什么格式，第一时间就应该想到 c.ShouldBind(&struct) 方法。