6.Gin 路由详解 - GET POST 请求以及参数获取示例

// 获取query参数示例：GET /user?uid=20&name=jack&page=1
r.GET("/user", func(c *gin.Context) {
    // 获取参数
    // Query获取参数
    uid := c.Query("uid")
    username := c.Query("name")
    // DefaultQuery获取参数，可以设置默认值：也就是如果没有该参数，则使用默认值
    page := c.DefaultQuery("page", "1")

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

// GET 获取path路径参数
r.GET("/book/:bid", func(c *gin.Context) {
    // 获取path参数
    bid := c.Param("bid")
    // 返回响应信息
    c.JSON(http.StatusOK, gin.H{
       "message": fmt.Sprintf("bid=%s", bid),
    })
})

// POST 请求示例：获取 form 表单的参数
r.POST("/addUser", func(c *gin.Context) {
    // 获取form表单参数
    // 使用PostForm获取单个参数
    username := c.PostForm("username")
    // DefaultPostForm如果没有设置该参数，则取默认值
    gender := c.DefaultPostForm("gender", "male")
    // PostFormArray 获取字符串数组参数
    hobby := c.PostFormArray("hobby")
    // 返回响应结果
    c.JSON(http.StatusOK, gin.H{
       "username": username,
       "gender":   gender,
       "hobby":    hobby,
    })
})

// User 定义结构体，注意首字母大写
type User struct {
    Username string `form:"username" json:"user"`
    Password string `form:"password" json:"password"`
}

// Get 传值绑定到结构体 /userinfo?username=jackson&password=123456
r.GET("/userinfo", func(c *gin.Context) {
    // 创建user对象
    var userinfo User
    // 使用ShouldBind绑定参数至对象
    if err := c.ShouldBind(&userinfo); err == nil {
       // 绑定成功，则返回结果
       c.JSON(http.StatusOK, userinfo)
    } else {
       // 绑定失败，则返回错误信息
       c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    }
})

// Post 传值绑定到结构体
r.POST("/login", func(c *gin.Context) {
    // 创建user对象
    var userinfo User
    // 使用ShouldBind绑定参数至对象
    if err := c.ShouldBind(&userinfo); err == nil {
       // 绑定成功，则返回结果
       c.JSON(http.StatusOK, userinfo)
    } else {
       // 绑定失败，则返回错误信息
       c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    }
})

// Article 定义xml参数的结构体
type Article struct {
    Title string `xml:"title"`
    Content string `xml:"content"`
}

// Post 获取 XML 请求体参数
r.POST("/xml", func(c *gin.Context) {
    // 从 c.Request.Body 读取请求数据
    body, _ := c.GetRawData()
    // 初始化结构体对象
    article := &Article{}
    // 使用xml.Unmarshal绑定参数至对象
    if err := xml.Unmarshal(body, &article); err == nil {
       // 绑定成功，则返回结果
       c.JSON(http.StatusOK, article)
    } else {
       // 绑定失败，则返回错误信息
       c.JSON(http.StatusBadRequest, err.Error())
    }
})

<?xml version="1.0" encoding="UTF-8"?>
<article>
    <content type="string">AI大时代</content>
    <title type="string">ChatGPT全解析</title>
</article>

// RequestBody 定义json参数的结构体
type RequestBody struct {
    Name  string `json:"name"`
    Email string `json:"email"`
}

// POST 获取 JSON 请求体参数
r.POST("/api/parsejson", func(c *gin.Context) {
    // 创建请求体的对象
    var reqBody RequestBody

    // 使用 ShouldBindJSON 将 JSON 请求体绑定到结构体
    if err := c.ShouldBindJSON(&reqBody); err != nil {
       // 如果解析失败，返回错误响应
       c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
       return
    }

    // 打印解析后的参数
    fmt.Printf("Name: %s\n", reqBody.Name)
    fmt.Printf("Email: %s\n", reqBody.Email)

    // 返回成功响应
    c.JSON(http.StatusOK, gin.H{
       "message": "JSON body parsed successfully",
       "reqBody": reqBody,
    })
})