校验结果为一个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
接口的其他方法来方便地获取特定的错误信息。
大多数情况下,我们不关心具体出错的校验规则,可以使用Error/String
方法直接返回所有的错误信息即可。大部分的方法获取错误信息时根据校验规则的顺序性与否,返回的结果顺序会不太一样。
简要说明:
获取校验结果的值可以通过多个校验结果方法获取,为让各位开发者有充分的理解,详细说明以下:
方法 | 说明 |
Code |
常用方法。实现gerror 的Code 接口,在校验组件中,该方法固定返回错误码gcode.CodeValidationFailed |
Error |
常用方法。实现标准库的error.Error 接口,获取返回所有校验错误组成的错误字符串。内部逻辑同String 方法 |
Current |
常用方法。实现了gerror 的Current 接口,用于获取校验错误中的第一条错误对象 |
Items |
在顺序性校验中将会按照校验规则顺序返回校验错误数组。其顺序性只有在顺序校验时有效,否则返回的结果是随机的 |
Map |
返回FirstItem 中的出错自规则及对应错误信息map |
Maps |
返回所有的出错键名及对应的出错规则及对应的错误信息(map[string]map[string]error ) |
String |
返回所有的错误信息,构成一条字符串返回,多个规则错误信息之间以; 符号连接。其顺序性只有使用顺序校验规则时有效,否则返回的结果是随机的 |
Strings |
返回所有的错误信息,构成[]string 类型返回。其顺序性只有使用顺序校验规则时有效,否则返回的结果是随机的 |
FirstItem |
在有多个键名/属性校验错误的时候,用以获取出错的第一个键名,以及其对应的出错规则和错误信息。其顺序性只有使用顺序校验规则时有效,否则返回的结果是随机的 |
FirstRule |
返回FirstItem中的第一条出错的规则及错误信息。其顺序性只有使用顺序校验规则时有效,否则返回的结果是随机的 |
FirstString |
返回FirstRule中的第一条规则错误信息。其顺序性只有使用顺序校验规则时有效,否则返回的结果是随机的 |
我们可以看到,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": "请选择用户类型",
},
}
"请输入用户姓名"
需要注意的是,数据校验时存在顺序性校验和非顺序性校验,这会对获取第一条错误信息的结果产生影响。
基本介绍我们之前提到可以使用Struct方法实现对struct对象的转换,那么我们当然也可以实现对struct数组的转换,st...
gview模板引擎支持两种layout模板布局方式:define+template方式include模板嵌入方式这两种方式均支持对模板...
在本章节中,我们将之前介绍HTTPClientServer的示例修改为GRPC微服务,并演示如何使用GoFrame框架开发一个简单的G...
ORM支持传递自定义的context上下文变量,用于异步IO控制、上下文信息传递(特别是链路跟踪信息的传递)、以及嵌套事...
资源管理设计的目标之一是在开发阶段不影响静态文件的开发管理,只有在发布的时候执行打包即可,打包完毕后清理临时文件,因此只...