Versions Compared

Old Version 7

changes.mady.by.user 郭强

Saved on

compared with

New Version Current

changes.mady.by.user 郭强

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

基本介绍

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

Code Block
languagego
// 校验错误信息: map[键名]map[规则名]错误信息
type ErrorMap map[string]map[string]string

// 校验错误对象
type Error
    func (e *Error) Error interface {
	Code() gcode.Code
	Current() error
	Error() string
	FirstItem() (key string, msgsmessages map[string]stringerror)
    func (e *Error) 	FirstRule() (rule string, err stringerror)
    func (e *Error) FirstString(	FirstError() (err stringerror)
    func (e *Error	Items() Map()items []map[string]map[string
    func (e *Error) ]error)
	Map() map[string]error
	Maps() ErrorMap
    func (e *Error) map[string]map[string]error
	String() string
    func (e *Error) 	Strings() (errs []string)

}

可以结合后续的示例理解这个数据结构。我们可以通过Maps()方法获得该原始错误信息数据结构map。但在大多数时候我们可以通过方法获得该原始错误信息数据结构map。但在大多数时候我们可以通过Error对象的其他方法来方便地获取特定的错误信息。接口的其他方法来方便地获取特定的错误信息。

Tip

大多数情况下，我们不关心具体出错的校验规则，可以使用Error/String方法直接返回所有的错误信息即可。方法直接返回所有的错误信息即可。大部分的方法获取错误信息时根据校验规则的顺序性与否，返回的结果顺序会不太一样。

简要说明：

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

  • FirstItem 在有多个键名/属性校验错误的时候，用以获取出错的第一个键名，以及其对应的出错规则和错误信息；其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的；
  • FirstRule 会返回FirstItem中得第一条出错的规则及错误信息；
  • FirstString 会返回FirstRule中得第一条规则错误信息；
  • Map 会返回FirstItem中得出错自规则及对应错误信息map;

    • 方法说明
    Code常用方法。实现gerror的Code接口，在校验组件中，该方法固定返回错误码 gcode.CodeValidationFailed。
    Error常用方法。实现标准库的error.Error接口，获取返回所有校验错误组成的错误字符串。内部逻辑同String方法。
    Current常用方法。实现了gerror的Current接口，用于获取校验错误中的第一条错误对象。
    Items在顺序性校验中将会按照校验规则顺序返回校验错误数组。其顺序性只有在顺序校验时有效，否则返回的结果是随机的。
    Map返回FirstItem中得出错自规则及对应错误信息map。
    Maps返回所有的出错键名及对应的出错规则及对应的错误信息
    Maps 会返回所有的出错键名及对应的出错规则及对应的错误信息
    (map[string]map[string]
    string
    error)
    ；
    。
    String
     会返回所有的错误信息，构成一条字符串返回，多个规则错误信息之间以
    返回所有的错误信息，构成一条字符串返回，多个规则错误信息之间以;
    符号连接；
    符号连接。其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的。
    Strings
     会返回所有的错误信息，构成
    返回所有的错误信息，构成[]string
    类型返回；
    类型返回。其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的。
    FirstItem在有多个键名/属性校验错误的时候，用以获取出错的第一个键名，以及其对应的出错规则和错误信息。其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的。
    FirstRule返回FirstItem中得第一条出错的规则及错误信息。其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的。
    FirstString返回FirstRule中得第一条规则错误信息。其顺序性只有使用顺序校验规则时有效，否则返回的结果是随机的。

    gerror.Current支持

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

    Code Block
    languagego
    func (a *contentApi) DoUpdate(r *ghttp.Requestpackage 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() {
	var (type User struct {
		dataName string `v:"required#请输入用户姓名"`
		Type int    `v:"required|min:1#|请选择用户类型"`
	}
	var (
		err  error
		ctx  = *define.ContentApiDoUpdateReqgctx.New()
		serviceUpdateReq *define.ContentServiceUpdateRequser = User{}
	)
	if err := r.ParseForm(&datag.Validator().Data(user).Run(ctx); err != nil {
		responseg.JsonExit(r, 1, gerror.Current(err).ErrorDump(err.(gvalid.Error).Maps())
	}
	if err := gconv.Struct(data, &serviceUpdateReq); err != nil {
		response.JsonExit(r, 1, err.Error(	g.Dump(gerror.Current(err))
	}
	if err := service.Content.Update(r.Context(), serviceUpdateReq); err != nil {
		response.JsonExit(r, 1, err.Error())
	} else {
		response.JsonExit(r, 0, "")
	}
}
    这里使用了gerror.Current(err).Error()来获取校第一条验错误信息。
    }

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

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


    Note

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






    Panel
    titleContent Menu

    Table of Contents