基本介绍

如果将之前的示例代码多执行几次之后会发现，返回的结果是没有排序的，而且字段及规则输出的先后顺序完全是随机的。即使我们使用FirstItem, FirstString()等其他方法获取校验结果也是一样，返回的校验结果不固定。那是因为校验的规则我们传递的是map类型，而golang的map类型并不具有有序性，因此校验的结果和规则一样是随机的，同一个校验结果的同一个校验方法多次获取结果值返回的可能也不一样了。

顺序校验

我们来改进一下以上的示例：校验结果中如果不满足required那么返回对应的错误信息，否则才是后续的校验错误信息；也就是说，返回的错误信息应当和我设定规则时的顺序一致。如下：

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/gogf/gf/v2/frame/g"
  6.     "github.com/gogf/gf/v2/os/gctx"
  7. )
  9. func main() {
  10.     var (
  11.         ctx    = gctx.New()
  12.         params = map[string]interface{}{
  13.             "passport":  "",
  14.             "password":  "123456",
  15.             "password2": "1234567",
  16.         }
  17.         rules = []string{
  18.             "passport@required|length:6,16#账号不能为空|账号长度应当在{min}到{max}之间",
  19.             "password@required|length:6,16|same:password2#密码不能为空|密码长度应当在{min}到{max}之间|两次密码输入不相等",
  20.             "password2@required|length:6,16#",
  21.         }
  22.     )  
  23.     err := g.Validator().Rules(rules).Data(params).Run(ctx)  
  24.     if err != nil {
  25.         fmt.Println(err.Map())
  26.         fmt.Println(err.FirstItem())
  27.         fmt.Println(err.FirstError())
  28.     }
  29. }

执行后，终端输出：

  1. map[length:账号长度应当在6到16之间 required:账号不能为空]
  2. passport map[length:账号长度应当在6到16之间 required:账号不能为空]
  3. 账号不能为空

可以看到，我们想要校验结果满足顺序性，只需要将rules参数的类型修改为[]string，按照一定的规则设定即可，并且msgs参数既可以定义到rules参数中，也可以分开传入（使用第三个参数）。rules的这种满足顺序性校验结果返回的规则，我们称之为gvalid tag，与前面Struct校验章节介绍的gvalid tag一致，具体请参考章节 Struct校验-基本使用 。