/goframe-v2

基本介绍

校验结果为一个error错误对象，内部使用gvalid.Error对象实现。当数据规则校验成功时，校验方法返回的结果为nil。当数据规则校验失败时，返回的该对象是包含结构化的层级map，包含多个字段及其规则及对应错误信息，以便于接收端能够准确定位错误规则。相关数据结构及方法如下： https://pkg.go.dev/github.com/gogf/gf/v2/util/gvalid

type Error interface {
    Code() gcode.Code
    Current() error
    Error() string
    FirstItem() (key string, messages map[string]error)
    FirstRule() (rule string, err error)
    FirstError() (err error)
    Items() (items []map[string]map[string]error)
    Map() map[string]error
    Maps() map[string]map[string]error
    String() string
    Strings() (errs []string)
}

可以结合后续的示例理解这个数据结构。我们可以通过Maps()方法获得该原始错误信息数据结构map。但在大多数时候我们可以通过Error接口的其他方法来方便地获取特定的错误信息。 :::tip 大多数情况下，我们不关心具体出错的校验规则，可以使用Error/String方法直接返回所有的错误信息即可。大部分的方法获取错误信息时根据校验规则的顺序性与否，返回的结果顺序会不太一样。 ::: 简要说明：

获取校验结果的值可以通过多个校验结果方法获取，为让各位开发者有充分的理解，详细说明以下：

gerror.Current 支持

我们可以看到， gvalid.Error 实现了 Current() error 接口，因此可以通过 gerror.Current 方法获取它的第一条错误信息，这在接口校验失败时返回错误信息非常方便。我们来看一个示例：

package main

import (
    "github.com/gogf/gf/v2/errors/gerror"
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
    "github.com/gogf/gf/v2/util/gvalid"
)

func main() {
    type User struct {
        Name string `v:"required#请输入用户姓名"`
        Type int    `v:"required|min:1#|请选择用户类型"`
    }
    var (
        err  error
        ctx  = gctx.New()
        user = User{}
    )
    if err = g.Validator().Data(user).Run(ctx); err != nil {
        g.Dump(err.(gvalid.Error).Maps())
        g.Dump(gerror.Current(err))
    }
}

这里使用了 gerror.Current(err) 来获取校第一条验错误信息。执行后，终端输出：

{
    "Name": {
        "required": "请输入用户姓名",
    },
    "Type": {
        "min": "请选择用户类型",
    },
}
"请输入用户姓名"

:::warning 需要注意的是，数据校验时存在 顺序性校验 和 非顺序性校验，这会对获取第一条错误信息的结果产生影响。关于顺序与非顺序性校验，具体可以参考后续章节介绍。 :::