coeditor/GinSkeleton/docs/validator.md

validator 表单参数验证器语法介绍

1.本篇将选取表单参数验证器( https://github.com/go-playground/validator )主要语法进行介绍，方便本项目骨架使用者快速上手.
2.更详细的语法参与参见官方文档：https://godoc.org/github.com/go-playground/validator

1.我们以用户注册代码块为例进行介绍.

1.用户注册代码详情, 摘取表单参数验证部分.
2.以下语法虽然看似简单，实际上已经覆盖了绝大部分常用场景的需求.

// 给出一些最常用的验证规则：
//required  必填；
//len=11 长度=11；
//min=3  如果是数字，验证的是数据大小范围，最小值为3，如果是文本，验证的是最小长度为3，
//max=6 如果是数字，验证的是数字最大值为6，如果是文本，验证的是最大长度为6
//mail 验证邮箱
//gt=3  对于文本就是长度>=3
//lt=6  对于文本就是长度<=6

 
type Register struct {
    // 必填、文本类型,表示它的长度>=1
	UserName string `form:"user_name" json:"user_name"  binding:"required,min=1"` 
   
    //必填，密码长度范围：【6,20】闭区间
	Pass string `form:"pass" json:"pass" binding:"required,min=6,max=20"`
    
    //  验证码，必填，长度等于：4 
	//Captcha string `form:"captcha" json:"captcha" binding:"required,len=4"` 

    //  年龄，必填，数字类型，大小范围【1,200】闭区间  
	//Age float64 `form:"age" json:"age" binding:"required,min=1,max=200"` 
    
    //  状态：必填，数字类型，大小范围：【0,1】 闭区间  ，
    //  注意： 如果你的表单参数含有0值是允许提交的，必须用指针类型（*float64），而 float64 类型则认为 0 值不合格
	Status *float64 `form:"status" json:"status"  binding:"required,min=0,max=1"`   
}

// 注意：这里的接收器 r，必须是 r Register, 绝对不能是 r *Register
// 因为在 ginskeleton 里面表单参数验证器是注册在容器的代码段，
// 如果是指针，带参数的接口请求，就会把容器的原始代码污染。
func (r Register) CheckParams(context *gin.Context) {
    // context.ShouldBind(&r) 则自动绑定 form-data 提交的表单参数
	if err := context.ShouldBind(&r); err != nil {

        //  省略非验证器逻辑代码....
        // ...  ...

	}
    
    //  如果您的客户端的数据是以json格式提交（popstman中的raw格式），那么就用如下语法
    // context.ShouldBindJson(&r) 则自动绑定 json格式提交的参数

}

2.以上语法特别说明.

1.对于数字类型（int8、int、int64、float32、float64等）我们统一使用 float64、*float64 接受.
2.如果您的业务要求数字格式为 int类型，那么使用 int() 等数据类型转换函数自行转换即可.