GoFrame框架数据校验之校验对象校验结构体

 更新时间:2022年06月20日 17:28:33   作者:王中阳Go  
这篇文章主要为大家介绍了GoFrame框架数据校验之校验对象校验结构体示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

前言摘要

这篇文章将会为大家介绍GoFrame数据校验中校验对象的知识点,包括:Validator对象常用方法的介绍、单数据校验、校验Map、校验结构体的示例。

基本概念

数据校验组件提供了数据校验对象:用于数据校验统一的配置管理,支持我们便捷的进行链式操作。

方法介绍

type Validator
    func New() *Validator
    func (v *Validator) CheckMap(params interface{}) Error
    func (v *Validator) CheckStruct(object interface{}) Error
    func (v *Validator) CheckValue(value interface{}) Error
    func (v *Validator) Clone() *Validator
    func (v *Validator) Ctx(ctx context.Context) *Validator
    func (v *Validator) Data(data interface{}) *Validator
    func (v *Validator) I18n(i18nManager *gi18n.Manager) *Validator
    func (v *Validator) Messages(messages interface{}) *Validator
    func (v *Validator) Rules(rules interface{}) *Validator

简要说明

  • New()方法用于创建一个新的校验对象。
  • CheckValue/CheckMap/CheckStruct方法用于特定参数类型的数据校验,我们在项目开发中使用比较多的是CheckStruct,也建议大家使用CheckStruct。
  • Ctx()方法用于传递Context上下文变量。
  • I18n()方法用于设置当前校验对象的I18N国际化组件,默认情况下,校验组件使用的是框架全局默认的i18n组件对象。
  • Data()方法用于设置需要校验的数据集合,支持map类型或者struct类型。
  • Rules()方法用于传递当前链式操作校验的自定义校验规则,支持使用[]string类型或者map类型。
  • Messages()方法用于传递当前链式操作校验的自定义错误提示信息,往往使用map类型传递,具体看后续代码示例。

注意问题TIPS

在数据校验对象的CheckValue/CheckMap/CheckStruct方法中,不存在Context上下文变量参数,而是通过链式操作的Ctx方法来控制。

GoFrame的g模块中定义了Validator方法来快捷创建校验对象:官方也推荐我们使用g模块的g.Validator()方式来快捷创建一个校验对象。

链式操作

示例1:单数据校验

简单示例

err := g.Validator().Rules("min:60").Messages("考试不及格").CheckValue(16)
    fmt.Println(err.String()) //打印结果:考试不及格

进阶示例

package main
import (
   "fmt"
   "github.com/gogf/gf/frame/g"
)
func main() {
   data := g.Map{
      "password": "123", //这个的作用仅是定义了这个结构设置了默认值,并不代表着传入了值
   }
   //Data()中的参数是需要进行校验的数据集合,常用于map或者结构体类型。
   //CheckValue()是输入的参数
   err := g.Validator().Data(data).Rules("required-with:password").Messages("请输入确认密码").CheckValue("")
   if err != nil {
      fmt.Println("CheckValue传入为空时:" + err.String()) // 请输入确认密码
   } else {
      fmt.Println("CheckValue传入为空时:校验通过")
   }
   err = g.Validator().Data(data).Rules("required-with:password").Messages("请输入确认密码").CheckValue("1")
   if err != nil {
      fmt.Println("CheckValue传入不为空时:" + err.String()) // 请输入确认密码
   } else {
      fmt.Println("CheckValue传入不为空时:校验通过")
   }
}

进阶示例打印结果

示例2:Map数据校验

params := map[string]interface{}{
	"passport":  "",
	"password":  "wangzhongyang",
	"password2": "zhongyang",
}
rules := map[string]string{
	"passport":  "required|length:6,16",
	"password":  "required|length:6,16|same:password2",
	"password2": "required|length:6,16",
}
messages := map[string]interface{}{
	"passport": "账号不能为空|账号长度应当在:min到:max之间",
	"password": map[string]string{
		"required": "密码不能为空",
		"same":     "两次密码输入不相等",
	},
}
err := g.Validator().Messages(messages).Rules(rules).CheckMap(params)
if err != nil {
	g.Dump(err.Maps())
}

执行后,终端输出:

{
    "passport": {
        "length": "账号长度应当在6到16之间",
        "required": "账号不能为空"
    },
    "password": {
        "same": "两次密码输入不相等"
    }
}

示例3:Struct数据校验

type User struct {
	Name string `v:"required#请输入用户姓名"`
	Type int    `v:"required#请选择用户类型"`
}
data := g.Map{
	"name": "wangzhongyang",
}
user := User{}
if err := gconv.Scan(data, &user); err != nil {
	panic(err)
}
err := g.Validator().Data(data).CheckStruct(user)
if err != nil {
	fmt.Println(err.Items()) //[map[Type:map[required:请选择用户类型]]]
}

总结

这篇文章为大家介绍了GoFrame数据校验之校验对象的知识点,包括:Validator对象常用方法的介绍、单数据校验、校验Map、校验结构体的示例。

更多关于GoFrame校验结构体的资料请关注脚本之家其它相关文章!

相关文章

  • Golang官方限流器库实现限流示例详解

    Golang官方限流器库实现限流示例详解

    这篇文章主要为大家介绍了Golang官方限流器库使用示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • 详解Go语言的错误处理和资源管理

    详解Go语言的错误处理和资源管理

    资源处理是什么?打开文件需要关闭,打开数据库连接,连接需要释放。这些成对出现的就是资源管理。有时候我们虽然释放了,但是程序在中间出错了,那么可能导致资源释放失败。如何保证打开的文件一定会被关闭呢?这就是资源管理与错误处理考虑的一个原因
    2021-06-06
  • Go如何优雅的使用字节池示例详解

    Go如何优雅的使用字节池示例详解

    在编程开发中,我们经常会需要频繁创建和销毁同类对象的情形,这样的操作很可能会对性能造成影响,这时常用的优化手段就是使用对象池(object pool),这篇文章主要给大家介绍了关于Go如何优雅的使用字节池的相关资料,需要的朋友可以参考下
    2022-08-08
  • go语言限制协程并发数的方案详情

    go语言限制协程并发数的方案详情

    一个线程中可以有任意多个协程,但某一时刻只能有一个协程在运行,多个协程分享该线程分配到的计算机资源,接下来通过本文给大家介绍go语言限制协程的并发数的方案详情,感兴趣的朋友一起看看吧
    2022-01-01
  • Goland 2020或2019软件版本去掉a...或fmt...提示的方法

    Goland 2020或2019软件版本去掉a...或fmt...提示的方法

    这篇文章主要介绍了Goland 2020或2019软件版本去掉a...或fmt...提示的方法,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-10-10
  • Golang 使用http Client下载文件的实现方法

    Golang 使用http Client下载文件的实现方法

    今天小编就为大家分享一篇Golang 使用http Client下载文件的实现方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-07-07
  • Go 防止 goroutine 泄露的方法

    Go 防止 goroutine 泄露的方法

    Go 的并发模型与其他语言不同,虽说它简化了并发程序的开发难度,但如果不了解使用方法,常常会遇到 goroutine 泄露的问题。本篇主要从如何写出正确代码的角度来介绍如何防止 goroutine 的泄露,需要的朋友可以参考下
    2019-09-09
  • Go语言带缓冲的通道实现

    Go语言带缓冲的通道实现

    这篇文章主要介绍了Go语言带缓冲的通道实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • Go语言中defer语句的用法

    Go语言中defer语句的用法

    这篇文章介绍了Go语言中defer语句的用法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • 浅谈go build后加文件和目录的区别

    浅谈go build后加文件和目录的区别

    这篇文章主要介绍了浅谈go build后加文件和目录的区别,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12

最新评论