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调试各种请求。 基本语法…

MySQL:什么样的字段适合加索引?什么样的字段不适合加索引

1 适合加索引的场景 (1)主键字段:用于唯一标识每个记录的字段,通常是数据库表中的一个自增或唯一标识字段。 (2)外键字段:用于连接两个表之间关系的字段,通常是一个表中的字段与另一个表中的主键字段关联。 (3)经常用于查询的字段:如果某个字段经常被用于查询条件…

新建jupyter notebook 出错

File “/home/map/huyong06/xdev/lib/python3.6/site-packages/notebook/utils.py”, line 36, in exists os.lstat(path) UnicodeEncodeError: ‘ascii’ codec can’t encode characters in position 28-30: ordinal not in range(128) [W 14:08:19.063 NotebookApp] Unhandl…

高稳定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用户打造。它支持高保真度的应用程序和网站原型设计,帮助用户快速创建高质量的产品原型。软件内置丰富的交互效果和动画设计选项,设计师可以通过简单的操作,为原型添加各种…

php获得淘宝商品评论 API

要获得淘宝商品评论的API,您可以使用淘宝开放平台的接口。以下是获取淘宝商品评论的一种方法: 注册成为淘宝开放平台的开发者。登录淘宝开放平台,创建应用,获取到App Key和App Secret。或者使用第三方App Key和App Secret生成签名…

Eclipse下WEB-INF/classes目录下没生成编译最新class文件

右击项目 >> Properties >>Deployment Assembly >>Source 把/src/main/java 的Deploy Path 改为 WEB-INF/classes

MYSQL之binlog详解优缺点

MYSQL之binlog详解 一、什么是binlog? binlog,即二进制日志,它记录了数据库上的所有改变,并以二进制的形式保存在磁盘中它可以用来查看数据库的变更历史、数据库增量备份和恢复、Mysql的复制(主从数据库的复制)二、binlog模式 …

大模型平台后端开发(xiaomi)

文章目录 算法题 算法题 1 三数之和 (注意去重的边界条件,过几天再刷几次) 2 长度最小的子数组 (代码随想录题目,滑动窗口) 3 用链表实现栈 package mainimport ("errors""fmt" )// Node 定义链表节点 type…

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

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

java安全可控、安可、国产信创、国产化有哪些替代品【完整版本】100%兼容测试

安全可控、安可、 国产信创、国产化 java安全可控、安可、国产信创、国产化有哪些替代品【完整版本】100%兼容测试 系统、芯片、CPU、缓存、数据库、中间件、负载均衡、WEB服务器、防火墙、消息队列 开发 角色: 前端☑ 后端☑ 测试□ 数据库☑ 产品✅ UI设计□ 是否熟悉国产…

python 合并 pdf

from pypdf import PdfMergerpdfs [file1.pdf, file2.pdf, file3.pdf, file4.pdf]merger PdfMerger()for pdf in pdfs:merger.append(pdf)merger.write("result.pdf") merger.close()参考 https://stackoverflow.com/questions/3444645/merge-pdf-files

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网络环境中自动为网络设备分配必要的配置信…