gin框架学习笔记(四) ——参数绑定与参数验证

参数绑定

前言

在Gin框架中我们可以利用bind来将前段传递过来的参数与结构体进行参数绑定与参数校验,而这bind的方式主要有以下两种:

  • Mustbind:一般使用较少,因为参数校验失败会改变状态码
  • Shouldbind:主要使用上的校验方法,校验失败的话会返回错误

Shouldbind绑定相关参数

  • 绑定Json参数
package mainimport ("fmt""github.com/gin-gonic/gin"
)type UserInfo struct {Username string `json:"username"`Age      int    `json:"age"`Sex      string `json:"sex"`
}func main() {r := gin.Default()r.POST("/json", func(c *gin.Context) {var user UserInfoerr := c.ShouldBindJSON(&user)if err != nil {fmt.Println("err:", err)c.JSON(200, gin.H{"code":    400,"message": "请求参数错误",})return}c.JSON(200, user)})r.Run(":8080")
}

这里我的侧是主要是两方面,一个是看参数错误的返回,一个是参数正确的返回:
在这里插入图片描述
在这里插入图片描述

  • 绑定查询参数
package mainimport ("fmt""github.com/gin-gonic/gin"
)
type UserInfo_Query struct {Username string `json:"username" form:"username"`Age      int    `json:"age" form:"age"`Sex      string `json:"sex" form:"sex"`
}func main() {r := gin.Default()r.GET("/query", func(c *gin.Context) {var user UserInfo_Queryerr := c.ShouldBindQuery(&user)if err != nil {fmt.Println("err:", err)c.JSON(200, gin.H{"code":    400,"message": "请求参数错误",})return}c.JSON(200, user)})r.Run(":8080")
}

运行结果:
在这里插入图片描述
在这里插入图片描述

  • 绑定url参数
package mainimport ("fmt""github.com/gin-gonic/gin"
)type UserInfo_Uri struct {Username string `json:"username" form:"username" uri:"username"`Age      int    `json:"age" form:"age" uri:"age"`Sex      string `json:"sex" form:"sex" uri:"sex"`
}
func main() {r := gin.Default()r.POST("/uri/:username/:age/:sex", func(c *gin.Context) {var user UserInfo_Urierr := c.ShouldBindUri(&user)if err != nil {fmt.Println("err:", err)c.JSON(200, gin.H{"code":    400,"message": "请求参数错误",})return}c.JSON(200, user)})r.Run(":8080")
}

在这里插入图片描述

  • 绑定表单参数
package mainimport ("fmt""github.com/gin-gonic/gin"
)type UserInfo_Form struct {Username string `json:"username" form:"username"`Age      int    `json:"age" form:"age"`Sex      string `json:"sex" form:"sex"`
}func main() {r := gin.Default()r.POST("/form", func(c *gin.Context) {var user UserInfo_Formerr := c.ShouldBind(&user)if err != nil {fmt.Println("err:", err)c.JSON(200, gin.H{"code":    400,"message": "请求参数错误",})return}c.JSON(200, user)})r.Run(":8080")
}

运行结果:
在这里插入图片描述

bind绑定器

正文前的碎碎念

我们在上面介绍了很多绑定参数的方法,我们可以通过它们将一些前端传递锅里的参数存储到结构体中,进而让我们去使用,但是我们在日常生活其实并没有这么简单,博主举一个简单的例子:博主小时候玩游戏的时候要申请账号,小时候博主很喜欢玩赛尔号,但是博主只有暑假才能玩,当时老是记不住密码。试过把密码抄在书上,但是老是忘了抄在哪里,当时想把密码就设成111它又不让,当时还差点给气哭来着(呜呜呜),那现在有一个问题,这种对密码的限制是怎么做到的呢?这就提到参数绑定了,让我们跟随赛尔号开始今天的内容了!
在这里插入图片描述

参数验证

在我们设置参数验证的时候,需要加binding tag

  • 常见验证器
    在我们说常见验证器的具体内容之前我先来演示一下验证器的作用,假如我们现在有一个密码注册页面,我们要求年龄在18岁以上,密码长度在6位以上,我们可以这么写:
package mainimport ("github.com/gin-gonic/gin""net/http"
)type User_enroll struct {Username string `json:"username" form:"username"`Age      int    `json:"age"  form:"age" binding:"gt=18"`Sex      string `json:"sex"  form:"sex"`Password string `json:"password" form:"password" binding:"min=8"`
}func main() {r := gin.Default()r.POST("/user", func(c *gin.Context) {var user User_enrollif err := c.ShouldBind(&user); err != nil {c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}c.JSON(200, user)})r.Run(":8080")
}

我们正常按照要求输入是可以正常返回的:
在这里插入图片描述
但是不按照binding要求的话,返回是这样的:
在这里插入图片描述
除此之外,常见验证器还有其他的限制条件表示方法,如下:

// 不能为空,并且不能没有这个字段
required: 必填字段,如:binding:"required"  // 针对字符串的长度
min 最小长度,如:binding:"min=5"
max 最大长度,如:binding:"max=10"
len 长度,如:binding:"len=6"// 针对数字的大小
eq 等于,如:binding:"eq=3"
ne 不等于,如:binding:"ne=12"
gt 大于,如:binding:"gt=10"
gte 大于等于,如:binding:"gte=10"
lt 小于,如:binding:"lt=10"
lte 小于等于,如:binding:"lte=10"// 针对同级字段的
eqfield 等于其他字段的值,如:PassWord string `binding:"eqfield=Password"`
nefield 不等于其他字段的值忽略字段,如:binding:"-"

内置验证器

Gin除了常见的验证器之外,还定义了一些它自身内置的验证器,它的语法与上面的基本一致,这里就不做过多讲解了。

// 枚举  只能是red 或green
oneof=red green // 字符串  
contains=fengfeng  // 包含fengfeng的字符串
excludes // 不包含
startswith  // 字符串前缀
endswith  // 字符串后缀// 数组
dive  // dive后面的验证就是针对数组中的每一个元素// 网络验证
ip
ipv4
ipv6
uri
url
// uri 在于I(Identifier)是统一资源标示符,可以唯一标识一个资源。
// url 在于Locater,是统一资源定位符,提供找到该资源的确切路径// 日期验证  1月2号下午3点4分5秒在2006年
datetime=2006-01-02

自定义验证器

自定义验证的错误消息

当我们验证参数出现错误的时候,原生的错误信息有时候并不是很友好,我们可以自己去定义返回的错误消息,示例如下:

package mainimport ("github.com/gin-gonic/gin""github.com/go-playground/validator/v10""reflect"
)type UserInfo struct {Username string `json:"username" binding:"required" msg:"用户名不能为空"`Password string `json:"password" binding:"min=3,max=6" msg:"密码长度不能小于3大于6"`
}// GetValidMsg 返回结构体中的msg参数
func _GetValidMsg(err error, obj any) string {// 使用的时候,需要传obj的指针getObj := reflect.TypeOf(obj)// 将err接口断言为具体类型if errs, ok := err.(validator.ValidationErrors); ok {// 断言成功for _, e := range errs {// 循环每一个错误信息// 根据报错字段名,获取结构体的具体字段if f, exits := getObj.Elem().FieldByName(e.Field()); exits {msg := f.Tag.Get("msg")return msg}}}return err.Error()
}func main() {r := gin.Default()r.POST("/user", func(c *gin.Context) {var user UserInfoerr := c.ShouldBindJSON(&user)if err != nil {c.JSON(400, gin.H{"msg": _GetValidMsg(err, &user)})return}c.JSON(200, user)})r.Run(":8080")
}

运行测试:
在这里插入图片描述

自定义验证器

  • 注册验证器函数
//注册验证器函数if v, ok := binding.Validator.Engine().(*validator.Validate); ok {v.RegisterValidation("sign", signValid)}r.Run(":8080")
  • 验证器函数的躯体实现:
func signValid(fl validator.FieldLevel) bool {// 获取字段值value := fl.Field().Interface().(string)// 验证规则if value == "fengxu" {return false}return true
}
  • 调用函数
type UserInfo struct {Username string `json:"username" binding:"sign" msg:"用户名设置错误"`Password string `json:"password" binding:"min=3,max=6" msg:"密码长度不能小于3大于6"`
}

完整代码:

package mainimport ("github.com/gin-gonic/gin""github.com/gin-gonic/gin/binding""github.com/go-playground/validator/v10""reflect"
)type UserInfo struct {Username string `json:"username" binding:"sign" msg:"用户名设置错误"`Password string `json:"password" binding:"min=3,max=6" msg:"密码长度不能小于3大于6"`
}// GetValidMsg 返回结构体中的msg参数
func _GetValidMsg(err error, obj any) string {// 使用的时候,需要传obj的指针getObj := reflect.TypeOf(obj)// 将err接口断言为具体类型if errs, ok := err.(validator.ValidationErrors); ok {// 断言成功for _, e := range errs {// 循环每一个错误信息// 根据报错字段名,获取结构体的具体字段if f, exits := getObj.Elem().FieldByName(e.Field()); exits {msg := f.Tag.Get("msg")return msg}}}return err.Error()
}func signValid(fl validator.FieldLevel) bool {// 获取字段值value := fl.Field().Interface().(string)// 验证规则if value == "fengxu" {return false}return true
}func main() {r := gin.Default()r.POST("/user", func(c *gin.Context) {var user UserInfoerr := c.ShouldBindJSON(&user)if err != nil {c.JSON(400, gin.H{"msg": _GetValidMsg(err, &user)})return}c.JSON(200, user)})//注册验证器函数if v, ok := binding.Validator.Engine().(*validator.Validate); ok {v.RegisterValidation("sign", signValid)}r.Run(":8080")
}

运行测试:
在这里插入图片描述

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/bicheng/13511.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Elasticsearch - HTTP

文章目录 安装基本语法索引创建索引查看索引删除索引 文档创建文档更新文档匹配查询多条件查询聚合查询映射 安装 https://www.elastic.co/downloads/past-releases/elasticsearch-7-17-0 下载完成启动bin/elasticsearch服务,可以在Postman调试各种请求。 基本语法…

高稳定LED驱动IC防干扰数显驱动控制器热水器LED驱动芯片VK1650 SOP16/DIP16 原厂FAE支持

产品型号:VK1650 产品品牌:永嘉微电/VINKA 封装形式:SOP16/DIP16 工程服务,技术支持! 概述 VK1650是一种带键盘扫描电路接口的 LED 驱动控制专用芯片,内部集成有数据锁存器、LED 驱动、键盘扫描等电路。…

2024年职称评审流程大揭秘,顺利拿下职称

上半年时间不急,中旬太忙,没有时间,下半年干着急。评职称一定要趁早,不然卡住一个流程,今年就不需要评职称了。中级副高级职称评职称就像挤公交你不努力挤一把,就只能等下一趟下一趟。所以评职称一定要看准…

[Cocos Creator 3.5赛车游戏] 第4节 创建汽车节点

在实现汽车节点之前,我们要先熟悉一下少量的基本概念,这样才能让您更快的实现第一个汽车节点。 一、基本概念 1.什么是节点: 在Cocos中,场景是由一系列节点组成的,每个节点下面又可以有子节点,而每个节点都…

Axure RP 9 for Mac:强大的原型设计利器

Axure RP 9 for Mac是一款功能强大的原型设计工具,专为Mac用户打造。它支持高保真度的应用程序和网站原型设计,帮助用户快速创建高质量的产品原型。软件内置丰富的交互效果和动画设计选项,设计师可以通过简单的操作,为原型添加各种…

记录计全支付切换到RabbitMQ时启动报错的问题

记录计全支付切换到RabbitMQ时启动报错的问题 首先在application.yml中切换到RabbitMQ配置安装RabbitMQ、Erlang、延时插件 rabbitmq_delayed_message_exchange,延迟插件必装 首先在application.yml中切换到RabbitMQ配置 # 第一处rabbitmq:addresses: 127.0.0.1:56…

Winform自定义控件 —— 开关

在开始阅读本文之前,如果您有学习创建自定义控件库并在其他项目中引用的需求,请参考:在Visual Studio中创建自定义Winform控件库并在其他解决方案中引用https://blog.csdn.net/YMGogre/article/details/126508042 0、引言 由于 Winform 框架并…

深入探索Jetpack Compose:大前端式客户端开发实战

💂 个人网站:【 摸鱼游戏】【神级代码资源网站】【工具大全】🤟 一站式轻松构建小程序、Web网站、移动应用:👉注册地址🤟 基于Web端打造的:👉轻量化工具创作平台💅 想寻找共同学习交…

(二)Jetpack Compose 布局模型

前文回顾 (一)Jetpack Compose 从入门到会写-CSDN博客 首先让我们回顾一下上一篇文章中里提到过几个问题: ComposeView的层级关系,互相嵌套存在的问题? 为什么Compose可以实现只测量一次? ComposeView和…

还拿B端设计经验,设计政务类系统,驴唇不对马嘴啦。

一、什么是政务类系统,涉及哪些领域 政务类系统是指用于政府机构或政府部门进行管理和运营的信息化系统。政务类系统的目的是提高政府工作效率、优化公共服务、加强政府与公民之间的互动和沟通。 政务类系统通常涵盖了各个方面的政府工作,包括但不限于以…

Media Encoder 2024 for Mac:专业的音视频编码神器

Media Encoder 2024 for Mac,作为Mac用户的专业音视频编码工具,凭借其强大的功能和用户友好的界面,深受专业人士的喜爱。它支持将各种格式的音视频素材转换为多种流行格式,如MP4、MOV、AVI等,满足不同的播放和发布需求…

计算机网络-DHCPv6基础

前面我们学习了IPv6地址可以通过手动配置、无状态自动配置、DHCPv6配置,这里简单学习下DHCPv6的知识点。 一、DHCPv6概述 DHCPv6 (Dynamic Host Configuration Protocol for IPv6) 是一种网络协议,设计用于IPv6网络环境中自动为网络设备分配必要的配置信…

NIOS II实现LED流水灯以及串口输出(DE2-115开发板)

NIOS II实现LED流水灯以及串口输出(DE2-115开发板) 前言什么是Qsys?什么是NIOSII?注意事项1、管脚配置2、配置NIOSII时的连接3、注意中断配置好后是这样的4、注意名称的配置5、设置双功能引脚 NIOS II的报错代码以及效果演示流水灯输出到电脑串口助手 …

盘点2024年自动猫砂盆品牌,哪个牌子自动猫砂盆比较好?

养猫之路漫漫,无论是新手还是老手,都需要细心照料猫咪的每一个需求。特别是在选择自动猫砂盆这个问题上,更是让人头疼不已。因为每只猫咪的喜好和习惯都不同,如果猫砂盆选得不对,猫咪可能会拒绝使用,导致家…

复制即用!纯htmlcss写的炫酷input输入框

一般我们写css样式都要用样式库,但是嫌麻烦,如果能找到现成的内容复制上去就很香了,下文是笔者觉得好看的纯html&css写的样式,可以直接复制到Vue等内,十分方便。 input组件 1) 下面这个很推荐&#…

南京中科微Si24R2E:低功耗2.4GHz有源RFID SoC单发射芯片+7dBm可调输出功率,节省应用成本

Si24R2E是针对有源RFID市场设计的低功耗、高性能的2.4GHz标签系统的SoC单芯片,集成嵌入式2.4GHz无线射频发射器模块、128次可编程NVM存储器模块以及自动发射控制器模块等。 Si24R2E芯片主要特性: 工作在2.4GHz ISM频段 内置128次可编程NVM存储器 具有…

男士内裤有什么牌子比较好?公认男士内裤口碑最好的品牌

现在市面上关于男士内裤有着三角平角两种设计,而在材质方面还有莫代尔、纯棉、冰丝等等各种不同的材质分类,另外还有各种不同的男士内裤品牌。 所以大家在选男士内裤都觉得十分麻烦而且耗费时间,那么今天我就来给大家总结分析一下男士内裤应…

微软中国 AI 团队搬至美国?可解决家属签证

多位网友爆料称,微软中国数百名员工收到公司邮件,询问是否愿意迁移至美国、澳大利亚、爱尔兰等国家工作。公司将负责亲属签证问题,以Azure云平台的AI团队为主,员工需要在6月7日前给出答复。 有微软员工表示情况属实,这…

文本三剑客-awk

一、awk的介绍 1.1awk的简介 AWK 是一种处理文本文件的语言,是一个强大的文本分析工具 可以在无交互的模式下实现复杂的文本操作 相较于sed常作用于一整个行的处理,awk则比较倾向于一行当中分成数个字段来处理,因为awk相当适合小型的文本…

Synerg FATAL

Synerg FATAL Synerg使用存在的问题 Synerg使用存在的问题 FATAL: failed to start server: cannot bind address: The specified address is not available from the local machine启动失败的原因,先排除是否有中文路径和电脑IP与软件IP是否一致,用Syn…