大家好，我是渔夫子。

明天给大家聊一聊gin框架中是如何解析申请中的json并对其进行验证的。

从一个示例开始

在上面这个示例中，定义了一个User构造体，该构造体中有3个字段：FirstName、LastName和Email。同时定义了一个校验函数 UserStructLevelValidation ，该函数对User构造体中的字段进行了校验。如下：

  • 校验FirstName和LastName是否为空
  • 对Email字段值进行正则校验，同时校验是否是空。

代码如下：

// User contains user information.type User struct {    FirstName string `json:"fname"`    LastName  string `json:"lname"`    Email     string `binding:"required,email"`}func UserStructLevelValidation(sl validator.StructLevel) {    user := sl.Current().Interface().(User)    if len(user.FirstName) == 0 && len(user.LastName) == 0 {        sl.ReportError(user.FirstName, "FirstName", "fname", "fnameorlname", "")        sl.ReportError(user.LastName, "LastName", "lname", "fnameorlname", "")    }    // plus can to more, even with different tag than "fnameorlname"}

那么问题来了：

第一：校验函数UserStructLevelValidation是如何和指标构造体User进行关联的？

第二：UserStructLevelValidation是在哪里被调用的？

第三：UserStructLevelValidation函数的入参为什么是validator.StructLevel类型？

第四：User构造体中的Email字段是如何被校验的？

第五：bingding tag都有哪些属性以及对应的含意？

接下来，咱们就一一解答上述所有问题，以便对构造体的验证有一个全面的理解。

校验函数和指标构造体是如何关联的

当咱们自定义了校验函数UserStructLevelValidation之后，在main函数中就能够通过以下代码和指标构造体User进行关联了：

import (    "net/http"    "github.com/gin-gonic/gin"    "github.com/gin-gonic/gin/binding"    validator "github.com/go-playground/validator/v10")func main() {    route := gin.Default()    if v, ok := binding.Validator.Engine().(*validator.Validate); ok {        v.RegisterStructValidation(UserStructLevelValidation, User{})    }    route.POST("/user", validateUser)    route.Run(":8085")}

通过代码咱们能够看到，校验函数和指标构造体是通过**v.RegisterStructValidation**函数进行关联的。该实例是将**UserStructLevelValidation**和**User**构造体进行了关联。

那么 v 又是什么对象呢？ 首先咱们晓得 v 是通过断言，转换成了 *validator.Validate类型。validator.Validate是应用的第三方包github.com/go-playground/validator/v10。

那么 binding.Validator 对象又是什么呢？通过源码可知，binding.Validator是gin框架中定义的一个全局的StructValidator类型的变量，其默认值是 defaultValidator 类型对象，defaultValidator中又定义了一个 validate *validator.Validate 字段。如下：

var Validator StructValidator = &defaultValidator{}type defaultValidator struct {    once     sync.Once    validate *validator.Validate}

所以，binding.Validator.Engine()函数本质上返回的是defaultValidator中的validate字段，也就是说 代码中的 v 变量 是validator.Validate类型的对象。

校验函数是在何处被调用的？

校验函数和要校验的指标构造体关联后，校验函数是在哪里被调用的呢？答案是在绑定申请参数中：ShouldBindJSON函数或其余ShouldBindXXX函数。

在下面示例中，注册了/user到validateUser的路由。在validateUser中，将申请参数和User类型的变量u进行了绑定，在绑定过程中，实际上是调用了UserStructLevelValidation函数的。 咱们看下具体的示例代码：

func validateUser(c *gin.Context) {    var u User    if err := c.ShouldBindJSON(&u); err == nil {        c.JSON(http.StatusOK, gin.H{"message": "User validation successful."})    } else {        c.JSON(http.StatusBadRequest, gin.H{            "message": "User validation failed!",            "error":   err.Error(),        })    }}

ShouldBindJSON函数底层实际上是调用的jsonBinding类型的Bind函数，而Bind函数调用decodeJSON函数，在decodeJSON函数中调用了validate，如下：

再看下validate函数，实际上是调用了Validator.ValidateStruct函数，如下：

Validator就是在问题1中咱们说的binding.Validator的变量，其值是defaultValidator类型，也就是说要调用该对象的ValidateStruct函数，如下：

咱们看到，当obj是构造体时就调用validateStruct函数，留神和ValidateStruct函数命名上的区别。在validateStruct函数中，又调用了defaultValidator中validate变量的Struct函数，也就是validator.Validate类型。
这里的validate变量就又和问题1中注册校验函数和指标构造体中的对象关联起来了。

校验函数的入参为什么是validator.StructLevel类型

在定义校验函数UserStructLevelValidation时，咱们看到该函数的入参是一个validator.StructLevel类型的变量，是为什么呢？

这个还是要从关联校验函数和指标构造体的RegisterStructValidation函数说起。进入RegisterStructValidation函数的源代码，会看到将校验函数UserStructLevelValidation进行了包装，如下：

通过wrapStructLevelFunc函数包装后，转换成了如下函数：

到这里 就看到了fn(sl)函数的调用了，fn就是注册的校验函数UserStructLevelValidation，参数sl就是StructLevel类型的变量。依据该类型的参数能够取得被校验的构造体对象。

所以，在校验函数中传入validator.StructLevel类型的变量是github.com/go-playground/validator/v10这个校验包的个性。

User构造体中的Email字段是如何被校验的？

在校验函数UserStructLevelValidation中，咱们并没有看到对User.Email字段的校验，但实际上又校验了，这是为什么呢？答案就在于该字段设置了binding的tag：binding:"required,email"。binding的tag是gin框架在初始化**github.com/go-playground/validator/v10** 包的对象时设置的。如下代码：

Engine函数是不是相熟，在注册校验函数时首先就调用了binding.Validator.Engine()。

binding tag都有哪些属性以及对应的含意？

binding标签是github.com/go-playground/validator/v10 包中设置的tag。其属性天然是和validator包有关系。validator反对的校验属性在baked_in.go文件中定义的，以下是反对的局部属性及对应的校验函数，若想理解更多 可间接拜访校验规定：

总结

本文通过一个示例介绍了在gin框架中如何解析申请并校验对应的构造体字段。gin实际上是调用了第三方包validator，并自定义了具体构造体的校验函数。

---特地举荐---

特地举荐：一个专一go我的项目实战、我的项目中踩坑教训及避坑指南、各种好玩的go工具的公众号，Go学堂，专一实用性，十分值得大家关注。