校验对象

数据校验组件同时提供了数据校验对象，常用于数据校验的统一的配置管理、便捷的链式操作。

接口文档： https://godoc.org/github.com/gogf/gf/util/gvalid

  1. type Validator
  2.     func New() *Validator
  3.     func (v *Validator) CheckMap(params interface{}) Error
  4.     func (v *Validator) CheckStruct(object interface{}) Error
  5.     func (v *Validator) CheckValue(value interface{}) Error
  6.     func (v *Validator) Clone() *Validator
  7.     func (v *Validator) Ctx(ctx context.Context) *Validator
  8.     func (v *Validator) Data(data interface{}) *Validator
  9.     func (v *Validator) I18n(i18nManager *gi18n.Manager) *Validator
  10.     func (v *Validator) Messages(messages interface{}) *Validator
  11.     func (v *Validator) Rules(rules interface{}) *Validator

简要说明：

  1. New方法用于创建一个新的校验对象。
  2. CheckValue/CheckMap/CheckStruct方法同之前介绍的包方法，用于特定参数类型的数据校验。
  3. Ctx方法用于传递Context上下文变量，作用也同之前介绍的每个包方法的第一个Context参数。
  4. I18n方法用于设置当前校验对象的I18N国际化组件，默认情况下，校验组件使用的是框架全局默认的i18n组件对象。
  5. Data方法用于传递需要联合校验的数据集合，往往传递的是map类型或者struct类型。
  6. Rules方法用于传递当前链式操作校验的自定义校验规则，往往使用[]string类型或者map类型。
  7. Messages方法用于传递当前链式操作校验的自定义错误提示信息，往往使用map类型传递，具体看后续代码示例。
  8. 可以看到，在数据校验对象的CheckValue/CheckMap/CheckStruct方法中，不存在Context上下文变量参数，而是转由链式操作的Ctx方法来控制。

由于数据校验对象也是一个非常常用的对象，因此g模块中定义了Validator方法来快捷创建校验对象。大部分场景下我们推荐使用g模块的g.Validator()方式来快捷创建一个校验对象，关于g模块的介绍请参考章节：对象管理

链式操作

示例1、单数据校验

  1. err := g.Validator().Rules("min:18").Messages("未成年人不允许注册哟").CheckValue(16)
  2. fmt.Println(err.String())
  4. // Output:
  5. // 未成年人不允许注册哟
  1. data := g.Map{
  2.     "password": "123",
  3. }
  4. err := g.Validator().Data(data).Rules("required-with:password").Messages("请输入确认密码").CheckValue("")
  5. fmt.Println(err.String())
  7. // Output:
  8. // 请输入确认密码

示例2、Map数据校验

  1. params := map[string]interface{}{
  2.     "passport":  "",
  3.     "password":  "123456",
  4.     "password2": "1234567",
  5. }
  6. rules := map[string]string{
  7.     "passport":  "required|length:6,16",
  8.     "password":  "required|length:6,16|same:password2",
  9.     "password2": "required|length:6,16",
  10. }
  11. messages := map[string]interface{}{
  12.     "passport": "账号不能为空|账号长度应当在:min到:max之间",
  13.     "password": map[string]string{
  14.         "required": "密码不能为空",
  15.         "same":     "两次密码输入不相等",
  16.     },
  17. }
  18. err := g.Validator().Messages(messages).Rules(rules).CheckMap(params)
  19. if err != nil {
  20.     g.Dump(err.Maps())
  21. }

执行后，终端输出：

  1. {
  2.     "passport": {
  3.         "length": "账号长度应当在6到16之间",
  4.         "required": "账号不能为空"
  5.     },
  6.     "password": {
  7.         "same": "两次密码输入不相等"
  8.     }
  9. }

示例3、Struct数据校验

  1. type User struct {
  2.     Name string `v:"required#请输入用户姓名"`
  3.     Type int    `v:"required#请选择用户类型"`
  4. }
  5. data := g.Map{
  6.     "name": "john",
  7. }
  8. user := User{}
  9. if err := gconv.Scan(data, &user); err != nil {
  10.     panic(err)
  11. }
  12. err := g.Validator().Data(data).CheckStruct(user)
  13. if err != nil {
  14.     fmt.Println(err.Items())
  15. }
  17. // Output:
  18. // [map[Type:map[required:请选择用户类型]]]

Content Menu