首页 > 脚本专栏 > Golang > Gin中数据解析和绑定

Gin中数据解析和绑定的几种方法实现

2025-11-21 10:47:02 作者：程序员WZ

本文主要介绍了Gin中数据解析和绑定的几种方法实现,包括Json数据、表单数据和URI数据,每种类型的数据都有其特定的解析和绑定方法,下面就一起来了解一下

概要

Gin数据解析和绑定可以分为三类

Json数据的解析和绑定
表单数据的解析和绑定
URI数据的解析和绑定

我们来分别讲解各自的数据类型以及对应的绑定和解析

Json数据解析和绑定

Json数据要解析到结构体时，需要在结构体标签中用到json标签，用于序列化Json数据并对应到结构体中

我们使用Context包下的ShouldBindJSON()方法将请求中传递的Json数据解析到结构体中

代码实现

type Login struct {
	Username string `json:"username" form:"username" binding:"required"`
	Password string `json:"password" form:"password" binding:"required"`
}

func main() {
	r := gin.Default()
	r.POST("/login", func(c *gin.Context) {
		var form Login
		if err := c.ShouldBind(&form); err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}

		if form.Username != "root" || form.Password != "root" {
			c.JSON(http.StatusBadRequest, gin.H{"error": "304"})
			return
		}
		c.JSON(http.StatusOK, gin.H{"data": form})
	})
	r.Run(":8080")
}
}

注意：

在结构体定义的时候一定要带上json标签，json标签的作用是让发送的json字符串数据能够对应到结构体字段上。

ShouldBindJSON()的作用是什么？该方法可以将前端传递的json格式数据自动解析到结构体上，并配合结构体中的json标签进行精准映射，简化了数据绑定过程

测试

这里我使用的工具是ApiFox
在工具中发送post请求，这里我们需要使用json格式发送，不能用query参数

表单数据解析和绑定

什么是表单数据？很简单，就是前端使用表单组件来提交数据的格式
表单数据也是键值对形式存储的，并且不支持嵌套。 username=root&password=root

前端实现

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
    <form action="http://localhost:8080/login" method="post" enctype="application/x-www-form-urlencoded">
        用户名<input type="text" name="username">

        密码<input type="password" name="password">
        <input type="submit" value="提交">
    </form>
</body>
</html>

这里指定了表单的编码方式为enctype="application/x-www-form-urlencoded"

后端实现

这里我们可以使用ShouldBind()或者Bind()方法进行数据解析

type Login struct {
	Username string `form:"username" json:"username" binding:"required"`
	Password string `form:"password" json:"password" binding:"required"`
}

func main() {
	r := gin.Default()
	r.POST("/login", func(c *gin.Context) {
		var form Login
		fmt.Println(form)
		if err := c.ShouldBind(&form); err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}
		if form.Username != "root" || form.Password != "root" {
			c.JSON(http.StatusBadRequest, gin.H{"error": "304"})
			return
		}
		c.JSON(http.StatusOK, gin.H{"data": form})
	})
	r.Run(":8080")
}

注意

注意结构体的标签中使用form标签，这样配合ShouldBind()方法可以将表单数据解析到结构体并对应到相应字段上

测试

打开本地创建的html文件，将前端代码复制到文件中，保存后在浏览器中打开

这里我们的用户名和密码都是root
发送请求后，页面应该响应出来一个json格式的数据

至于错误的用户名和密码是什么效果，可以自行测试

URI数据解析和绑定

什么是URI？注意是uri，不是url。url是uri的子集，这里我们只需要知道uri可以是url，也就是我们访问资源的时候，斜杠后边的内容，即访问路径。

比如localhost:8080/login/root/root，这时候可以把uri看成url，并且我们可以通过shouldBindUri()将路径中的两个root进行数据解析，解析到Login结构体中，并且通过结构体中的uri标签，将数据映射到对应的结构体字段上。

代码实现

type Login struct {
	Username string `form:"username" json:"username" uri:"username" binding:"required"`
	Password string `form:"password" json:"password" uri:"password" binding:"required"`
}

func main() {
	r := gin.Default()
	r.GET("/:username/:password", func(c *gin.Context) {

		var form Login
		if err := c.ShouldBindUri(&form); err != nil {
			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
			return
		}
		if form.Username != "root" || form.Password != "root" {
			c.JSON(http.StatusBadRequest, gin.H{"status": 304})
			return
		}
		c.JSON(http.StatusOK, gin.H{"status": 200})
	})
	r.Run(":8080")
}

注意

结构体中要带上uri标签，这样可以结合ShouldBindUri进行数据绑定的简化

测试

我们打开浏览器，输入localhost:8080/root/root，这里和我们的代码中定义的路径对应，代码中没有写login/:username/:password那我们请求时也不带login，并且代码中定义的只返回一个200状态码，这些内容都可以根据实际情况进行更改

此时，三种类型的数据解析和绑定我们就都测试完毕

小结

从上边的三个demo可以看到，gin处理这些不同类型的数据对应了不同的方法，我们需要使用正确的方法进行处理，保证了代码的灵活性，也可以减少错误率

到此这篇关于Gin中数据解析和绑定的几种方法实现的文章就介绍到这了,更多相关Gin中数据解析和绑定内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Golang中gin框架绑定解析json数据的两种方法