Golang验证器之validator是使用详解
作者:yi个俗人 发布时间:2024-01-29 23:40:28
前言
对于HTTP请求,我们要在脑子里有一个根深蒂固的概念,那就是任何客户端传过来的数据都是不可信任的。那么开发接口的时候需要对客户端传提交的参数进行参数校验,如果提交的参数只有一个两个,这样我们可以简单写个if判断,那么要是有很多的参数校验,那么满屏都是参数校验的if判断,效率不仅低还不美观,接下来我们介绍一个参数校验器validator
。
什么是validator
Validator
是一个 Golang 的第三方库,用于对数据进行校验,常用于 API 的开发中,对客户端发出的请求数据进行严格校验,防止恶意请求。
安装
validator包安装:
go get -u github.com/go-playground/validator/v10
使用方法
导入validator:
import "github.com/go-playground/validator/v10"
validator 应用了 Golang
的 Struct Tag
和 Reflect
机制,基本思想是:在 Struct Tag
中为不同的字段定义各自类型的约束,然后通过 Reflect
获取这些约束的类型信息并在校验器中进行数据校验。
示例:
package main
import (
"fmt"
"github.com/go-playground/validator/v10"
)
type User struct {
UserName string `json:"user_name" validate:"required"`
Password string `json:"password" validate:"required,min=6,max=20"`
}
func main() {
example := User{
Password: "123",
}
//实例化验证器
validate := validator.New()
errs := validate.Struct(example)
if errs != nil {
for _, err := range errs.(validator.ValidationErrors) {
fmt.Println(err)
}
}
}
validator包的验证提示默认是英文的,输出如下:
这样看可能不太清楚,如果需要翻译成中文则还需安装验证提示翻译包:
go get -u github.com/go-playground/locales
go get -u github.com/go-playground/universal-translator
修改后如下:
package main
import (
"fmt"
"github.com/go-playground/locales/zh"
ut "github.com/go-playground/universal-translator"
"github.com/go-playground/validator/v10"
zh_translations "github.com/go-playground/validator/v10/translations/zh"
)
type User struct {
UserName string `json:"user_name" validate:"required"`
Password string `json:"password" validate:"required,min=6,max=20"`
}
func main() {
example := User{
Password: "123",
}
// 中文翻译器
uni := ut.New(zh.New())
trans, _ := uni.GetTranslator("zh")
//实例化验证器
validate := validator.New()
// 注册翻译器到校验器
err := zh_translations.RegisterDefaultTranslations(validate, trans)
if err!=nil {
fmt.Println(err)
return
}
errs := validate.Struct(example)
if errs != nil {
for _, err := range errs.(validator.ValidationErrors) {
fmt.Println(err.Translate(trans))
}
}
}
执行输出:
校验规则
下面列举一部分我们开发中经常用到的验证规则,详细验证规则可以参考文档:
https://pkg.go.dev/gopkg.in/go-playground/validator.v10
Tag | 说明 | 示例 |
---|---|---|
required | 必填 | Field或Struct validate:"required" |
omitempty | 空时忽略 | Field或Struct validate:"omitempty" |
len | 长度 | Field validate:"len=0" |
eq | 等于 | Field validate:"eq=0" |
gt | 大于 | Field validate:"gt=0" |
gte | 大于等于 | Field validate:"gte=0" |
lt | 小于 | Field validate:"lt=0" |
lte | 小于等于 | Field validate:"lte=0" |
min | 最小值 | Field validate:"min=1" |
max | 最大值 | Field validate:"max=2" |
required_with | 其他字段其中一个不为空且当前字段不为空 | Field validate:"required_with=Field1 Field2" |
required_without | 其他字段其中一个为空且当前字段不为空 | Field `validate:“required_without=Field1 Field2” |
lowercase | 符串值是否只包含小写字符 | Field validate:"lowercase" |
uppercase | 符串值是否只包含大写字符 | Field validate:"uppercase" |
字符串值包含一个有效的电子邮件 | Field validate:"email" | |
json | 字符串值是否为有效的JSON | Field validate:"json" |
url | 符串值是否包含有效的url | Field validate:"url" |
uri | 符串值是否包含有效的 uri | Field validate:"uri" |
contains | 字符串值包含子字符串值 | Field validate:"contains=@" |
excludes | 字符串值不包含子字符串值 | 字符串值不包含子字符串值 Field validate:"excludes=@" |
ip | 字符串值是否包含有效的 IP 地址 | Field validate:"ip" |
datetime | 字符串值是否包含有效的日期 | Field validate:"datetime" |
startswith | 字符串以提供的字符串值开始 | Field validate:"startswith=abc" |
endswith | 字符串以提供的字符串值结束 | Field validate:"endswith=abc" |
跨字段验证
validator 允许定义跨字段验证,即:验证某个字段与其他字段之间的关系。这种验证实际上分为两种:
一种是参数字段就是同一个结构体中的平级字段。
另一种是参数字段为结构中其他字段的字段。
验证语法很简单,如果是验证同一个结构中的字段,则在基础的 Tags 后面添加一个 field 后缀,例如:eqfield 定义字段间的相等(eq)约束。如果是更深层次的字段,在 field 之前还需要加上 cs(Cross-Struct),eq 就变为了 eqcsfield。
eqfield=Field:必须等于 Field 的值。
nefield=Field:必须不等于 Field 的值。
gtfield=Field:必须大于 Field 的值。
gtefield=Field: 必须大于等于 Field 的值。
ltfield=Field:必须小于 Field 的值。
ltefield=Field:必须小于等于 Field 的值。
eqcsfield=Other.Field:必须等于 struct Other 中 Field 的值。
necsfield=Other.Field:必须不等于 struct Other 中 Field 的值。
gtcsfield=Other.Field:必须大于 struct Other 中 Field 的值;
gtecsfield=Other.Field:必须大于等于 struct Other 中 Field 的值。
ltcsfield=Other.Field:必须小于 struct Other 中 Field 的值。
ltecsfield=Other.Field:必须小于等于 struct Other 中 Field 的值。
另外还有几个常用的 Tag:
required_with=Field1 Field2:在 Field1 或者 Field2 存在时,必须;
required_with_all=Field1 Field2:在 Field1 与 Field2 都存在时,必须;
required_without=Field1 Field2:在 Field1 或者 Field2 不存在时,必须;
required_without_all=Field1 Field2:在 Field1 与 Field2 都存在时,必须;
错误处理
通过看源码,我们可以看到validator 返回的错误有两种,一种是参数错误,一种是校验错误,它们都实现了 error 接口。
参数错误时,返回 InvalidValidationError 类型;
校验错误时,返回 ValidationErrors 类型。ValidationErrors 是一个错误切片,保存了每个字段违反的每个约束信息。
所以 validator 校验返回的结果有 3 种情况:
nil:没有错误;
InvalidValidationError:输入参数错误;
ValidationErrors:字段违反约束。
validator 返回的错误有两种,一种是参数错误,一种是校验错误,它们都实现了 error 接口。
参数错误时,返回 InvalidValidationError 类型;
校验错误时,返回 ValidationErrors 类型。ValidationErrors 是一个错误切片,保存了每个字段违反的每个约束信息。
所以 validator 校验返回的结果只有 3 种情况:
nil:没有错误;
InvalidValidationError:输入参数错误;
ValidationErrors:字段违反约束。
我们可以在程序中判断 err != nil
时,可以依次将 err转换为 InvalidValidationError
和 ValidationErrors
以获取更详细的信息:
err := validate.Struct(user)
if err != nil {
invalid, ok := err.(*validator.InvalidValidationError)
if ok {
fmt.Println("param error:", invalid)
return
}
validationErrs := err.(validator.ValidationErrors)
for _, validationErr := range validationErrs {
fmt.Println(validationErr)
}
}
小结
通过以上的内容我们了解了validator
一些基本的功能和用法,在我们开发中大大提高了开发效率。
validator
功能非常丰富,使用较为简单方便。它的应用非常广泛,建议了解一下。
来源:https://juejin.cn/post/7133399499418337311
猜你喜欢
- 使用matplotlib绘图时,在弹出的窗口中默认是有工具栏的,那么这些工具栏是如何定义的呢?工具栏的三种模式matplotlib的基础配置
- Mysql 中数据是要落盘的,这点大家都知道。读写磁盘速度是很慢的,尤其和内存比起来更是没的说。但是,我们平时在执行 SQL 时,无论写操作
- 概述相信我们经常会遇到这样的场景:想要了解双十一天猫购买化妆品的人员中平均消费额度是多少(这可能有利于对商品价格区间的定位);或者不同年龄段
- 本文实例为大家分享了python实现人机对战井字棋的具体代码,供大家参考,具体内容如下游戏简介:在九宫格内进行,如果一方抢先于另一方向(横、
- 我们通常所说的DML、DDL、DCL语句都是sql*plus语句,它们执行完后,都可以保存在一个被称为sql buffer的内存区域中,并且
- python——pip install xxx报错SyntaxError: invalid syntax在安装好python后,进入pyth
- 首先将一个字典转化为DataFrame,然后以DataFrame中的列进行频次统计。代码如下:import pandas as pda={&
- 之前的文章介绍了python抓取网页数据并将数据保存到本地excel文件,后续可以将数据保存到数据库(SqlServer、mysql等)中,
- 在网上看了很多解决方法,都没有解决,后来我自己解决了这个问题:出现的问题:在cmd上 “pip install package” 时显示 s
- 下面的demo是根据需求写的简单测试脚本#!/usr/bin/env python# coding: utf-8# 第一个列表为依赖组件和版
- Matplotlib 是一个 Python 的 2D绘图库,它以各种硬拷贝格式和跨平台的交互式环境生成出版质量级别的图形
- 有时候在网上办理一些业务时有些需要填写银行卡号码,当胡乱填写时会立即报错,但是并没有发现向后端发送请求,那么这个效果是怎么实现的呢。对于银行
- 客户用的数据库是mysql,而研发好的产品支持oracle,为了让客户掏腰包,我们必须把数据库环境从oracle转向mysql。我们在转换的
- 了解SQL Server 2005数据库的朋友可能都知道,tempdb系统数据库是一个全局资源,可供连接到SQL Server 2005实例
- 最近发现周围的很多小伙伴们都不太乐意使用pandas,转而投向其他的数据操作库,身为一个数据工作者,基本上是张口pandas,闭口panda
- 二维正态分布采样后,绘制置信椭圆假设二维正态分布表示为:下图为两个二维高斯分布采样后的置信椭圆和每个二维高斯分布采样100个数据点,图片为:
- 1)视频读取import cv2cap = cv2.VideoCapture('E:\\Video\\20000105_224116
- 一、目录权限设置很重要:可以有效防范黑客上传木马文件. 如果通过 chmod 644 * -R 的话,php文件就没有权限访问了。 如果通过
- 效果图守卫类游戏大家应该玩过吧,什么植物大战僵尸呀,保卫萝卜呀,今天我们自己用python来写一个自己的守护类小游戏兔子猎人守护城堡,让大家
- 本文实例讲述了Python实现的ftp服务器功能。分享给大家供大家参考,具体如下:python 具备强大的网络编程功能,而且代码简介,用简单