Gin golang web開發(fā)模型綁定實現(xiàn)過程解析
我們了解到gin可用通過類似DefaultQuery或DefaultPostForm等方法獲取到前端提交過來的參數。參數不多的情況下也很好用，但是想想看，如果接口有很多個參數的時候再用這種方法就要調用很多次獲取參數的方法，本文將介紹一種新的接收參數的方法來解決這個問題：模型綁定。
gin中的模型綁定可以理解為：把請求的參數映射為一個具體的類型。gin支持JSON，XML，YAML和表單參數等多種參數格式，只需要在對應的字段上聲明標簽。
綁定表單或者查詢字符串
type Person struct {
Name string `form:"name"`
Address string `form:"address"`
}
func startPage(c *gin.Context) {
var person Person
if c.ShouldBindQuery(&person) == nil {
log.Println(person.Name)
log.Println(person.Address)
}
c.String(200, "Success")
}
在結構體Name字段聲明form標簽，并調用ShouldBindQuery方法，gin會為我們綁定查詢字符串中的name和address兩個參數。注意雖然我們聲明了form標簽，ShouldBindQuery只綁定查詢字符串中的參數。
如果你想綁定表單中的參數的話結構體不用改變，需要把ShouldBindQuery方更改為ShouldBind方法。ShouldBind方法會區(qū)分GET和POST請求，如果是GET請求綁定查詢字符串中的參數，如果是POST請求綁定表單參數中的內容，但是不能同時綁定兩種參數。
綁定json參數
type Person struct {
Name string `json:"name"`
Address string `json:"address"`
}
func startPage(c *gin.Context) {
var person Person
if c.ShouldBind(&person) == nil {
log.Println(person.Name)
log.Println(person.Address)
}
c.String(200, "Success")
}
json是一種常用的數據交換格式，尤其是在和web前端頁面交互的時候，似乎已經成為了一種事實標準。gin綁定json格式數據方法很簡單，只需要設置字段的標簽為json并且調用ShouldBind方法。
其他類型參數綁定
路由參數在綁定時設置標簽為uri，并調用ShouldBindUri方法。
type Person struct {
Id string `uri:"id"`
}
func startPage(c *gin.Context) {
var person Person
if c.ShouldBindUri(&person) == nil {
log.Println(person.Id)
}
c.String(200, "Success")
}
綁定在HTTP Header中的參數，字段的標簽設置為header，調用方法為ShouldBindHeader。
還有不太常用的數組參數是字段標簽設置為form:"colors[]"，結構體例子如下：
type myForm struct {
Colors []string `form:"colors[]"`
}
文件上傳這種場景我很少用模型綁定的方式獲取參數，在gin中對于這種場景也提供了模型綁定支持。
type ProfileForm struct {
Name string `form:"name"`
Avatar *multipart.FileHeader `form:"avatar"`
// Avatars []*multipart.FileHeader `form:"avatar"` 多文件上傳
}
func main() {
router := gin.Default()
router.POST("/profile", func(c *gin.Context) {
var form ProfileForm
if err := c.ShouldBind(&form); err != nil {
c.String(http.StatusBadRequest, "bad request")
return
}
err := c.SaveUploadedFile(form.Avatar, form.Avatar.Filename)
if err != nil {
c.String(http.StatusInternalServerError, "unknown error")
return
}
c.String(http.StatusOK, "ok")
})
router.Run(":8080")
}
多種類型的模型綁定
如果我們有一個UpdateUser接口，PUT /user/:id，參數是{"nickname": "nickname...","mobile": "13322323232"}。代碼如下：
type ProfileForm struct {
Id int `uri:"id"`
Nickname string `json:"nickname"` // 昵稱
Mobile string `json:"mobile"` // 手機號
}
func main() {
router := gin.Default()
router.GET("/user/:id", func(c *gin.Context) {
var form ProfileForm
if err := c.ShouldBindUri(&form); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
if err := c.ShouldBindJSON(&form); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
c.String(http.StatusOK, "ok")
})
router.Run(":8080")
}
代碼里調用了兩次bind方法才獲取到全部的參數。和gin社區(qū)溝通之后發(fā)現(xiàn)目前還不能調用一個方法同時綁定多個參數來源，當前gin版本為1.6.x，不知道未來會不會提供這種功能。
以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
Go語言的Windows下環(huán)境配置以及簡單的程序結構講解
這篇文章主要介紹了Go語言的Windows下環(huán)境配置以及簡單的程序結構講解,從編程語言約定俗成的hellow world開始,需要的朋友可以參考下2015-10-10
在日常開發(fā)中,我們通常需要針對現(xiàn)有的功能進行單元測試,以驗證開發(fā)的正確性,本文主要介紹了Go語言單元測試的實現(xiàn)及用例,具有一定的參考價值,感興趣的可以了解一下2024-01-01
*gin.Context是處理HTTP請求的核心,ctx代表"context"（上下文）,它包含了處理請求所需的所有信息和方法,例如請求數據、響應構建器、路由參數等,這篇文章主要介紹了Go中gin框架的*gin.Context參數常見實用方法,需要的朋友可以參考下2024-07-07
這篇文章主要為大家詳細介紹了在 golang 中執(zhí)行 shell 命令的多種方法和場景,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學習一下2024-02-02
基于Golang實現(xiàn)Excel表格的導入導出功能
最近項目開發(fā)中有涉及到Excel的導入與導出功能,特別是導出表格時需要特定的格式,所以本文給大家介紹了基于Golang實現(xiàn)Excel表格的導入導出功能,文中通過代碼示例和圖文介紹的非常詳細,需要的朋友可以參考下2023-12-12
在Go語言開發(fā)中,JSON因其簡潔和廣泛的兼容性,通常被用作數據交換的主要序列化格式,本文將探討JSON希望對大家有所幫助序列化的一些局限性,也算是一個小坑吧,并給出一些常用的解決方案,2024-11-11
Golang實現(xiàn)深拷貝reflect原理示例探究
這篇文章主要為大家介紹了Golang實現(xiàn)reflect深拷貝原理示例探究,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2024-01-01
這篇文章主要介紹了Go語言實現(xiàn)布谷鳥過濾器的方法,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-03-03
使用GO語言實現(xiàn)Mysql數據庫CURD的簡單示例
本文主要介紹了使用GO語言實現(xiàn)Mysql數據庫CURD的簡單示例，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-08-08
這篇文章主要介紹了Go語言中init函數與匿名函數使用淺析，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習吧2023-01-01