当前位置:首页 » 《随便一记》 » 正文

探索Gin框架:Golang Gin框架请求参数的获取

20 人参与  2024年02月08日 17:11  分类 : 《随便一记》  评论

点击全文阅读


前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到网站https://www.captainbed.cn/kitie。

前言

我们在专栏的前面几篇文章内讲解了Gin框架的路由配置,服务启动等内容。

专栏地址:https://blog.csdn.net/qq_35716689/category_12575301.html

在我们平常添加路由处理函数之后,就可以在路由处理函数中编写业务处理代码了,但在此之前我们往往需要获取请求参数,本文就详细的讲解下gin获取请求参数常见的几种方式。

目录

前言

传递参数的方式

Header

URL

HTTP Body

直接获取请求参数

获取URL Path中的参数

获取URL Query中的参数

获取HTTP Body中的参数

绑定请求参数

绑定Header参数

绑定URL Path参数

绑定URL Query参数

绑定HTTP Body参数

数据校验

两种方式的对比

小结


传递参数的方式

在一个HTTP请求中,一般可以把上传参数分为以下三个部分:

Header

Header是HTTP请求中一个键值对集合,HTTP规范定义了很多的Headeer,比如Content-Type,Accept等,不过也可以自定义请求头部或者响应头部。

URL

URL指的是请求路径,在请求路径上可以通过两种方式携带请求参数,一种是直接写在请求路径上的,称为URL Path:

http://localhost:8080/user/add

在URL上传递参数的另外一种方式就是URL Query,URL Query参数是指跟在?后面的键值对集合,多个参数之间以&分隔的:

http://localhost:8080/user/add?name=小明&gender=男

HTTP Body

HTTP Body参数是指HTTP请求的请求体所携带的参数,这部分参数会因为Content-Type不同而不同,比如当Content-Type为application/json时,HTTO Body携带的是一串JSON字符串。

那么,在Gin框架中,要如何获取这些请求参数呢?主要有以下两种方式:

直接用Gin封装的方法获取请求参数通过绑定的方式来获取请求参数

直接获取请求参数

Gin框架在net/http包的基础上封装了获取参数的方式。

获取URL Path中的参数

在路由中使用通配符时,对应的通配符就会成为URL Path参数,调用gin.Context的Param()方法可以获取Path参数:

 package main ​ func main(){   engine := gin.Default()   engine.GET("/user/:id", func(ctx *gin.Context) {     id := ctx.Param("id")     fmt.Fprintf(ctx.Writer, "你的请求id:%s", id)   })     engine.Run() }

运行后发起请求:

 $ curl http://localhost:8080/user/100 你的请求id:100

获取URL Query中的参数

gin.Context对象提供了以下几个主要方法用于获取Query参数:

 package main ​ import (   "fmt" ​   "github.com/gin-gonic/gin" ) ​ func main() {   engine := gin.New()   engine.GET("/user/list", func(ctx *gin.Context) {     //获取单个值     name := ctx.Query("name")     //带默认值     gender := ctx.DefaultQuery("gender", "男")     //数组     habits := ctx.QueryArray("habits")     //map     works := ctx.QueryMap("works")     fmt.Printf("%s,%s,%s,%s\n", name, gender, habits, works)   }) ​   engine.Run() }

运行后发起请求:

curl -X GET "http://localhost:8080/user/list?name=John&gender=男&habits[]=reading&habits[]=sports&works[teacher]=math&works[engineer]=computer"John,男,[reading sports],map[engineer:computer teacher:math]

获取HTTP Body中的参数

对于通过HTTP Body传上来的参数,gin.Context也提供了几种主要方法用于获取:

 package main ​ import (   "fmt" ​   "github.com/gin-gonic/gin" ) ​ func main() {   engine := gin.New()   engine.POST("/user/add", func(ctx *gin.Context) {     //获取单个值     name := ctx.PostForm("name")     //带默认值     gender := ctx.DefaultPostForm("gender", "男")     //数组     habits := ctx.PostFormArray("habits")     //map     works := ctx.PostFormMap("works")     fmt.Printf("%s,%s,%s,%s\n", name, gender, habits, works)   }) ​   engine.Run() }

绑定请求参数

Gin支持绑定Header,URL Path,URL Query以及HTTP Body等不同位置数据。

绑定Header参数

绑定Header参数可以使用BindHeader()或者ShouldBindHeader()方法:

 package main ​ import (   "fmt"   "net/http" ​   "github.com/gin-gonic/gin" ) ​ type testHeader struct {   Rate   int    `header:"Rate"`   Domain string `header:"Domain"` } ​ func main() {   r := gin.Default()   r.GET("/", func(c *gin.Context) {     h := testHeader{} ​     if err := c.ShouldBindHeader(&h); err != nil {       c.JSON(http.StatusBadRequest, err)       return     } ​     fmt.Printf("%#v\n", h)     c.JSON(http.StatusOK, gin.H{"Rate": h.Rate, "Domain": h.Domain})   }) ​   r.Run() }

运行后的请求结果:

$ curl -H "rate:300" -H "test:123" http://localhost:8080/{"Test":"123","Rate":300}

绑定URL Path参数

绑定URL Path参数可以使用BindUri()或者ShouldBindUri()方法:

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  string `uri:"name"`  Email string `uri:"email"`}func main() {engine := gin.New()engine.GET("/user/list/:email/:name", func(ctx *gin.Context) {var u Userif err := ctx.BindUri(&u);err != nil {ctx.JSON(http.StatusBadRequest, err)return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

运行后的请求结果: 

curl -X GET "http://localhost:8080/user/list/john@163.com/john你输入的用户名为:john,邮箱为:john@163.com

绑定URL Query参数

绑定URL Query参数可以使用BindQuery()、ShouldBindQury()、Bind()或者ShouldBind()方法:

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  string `form:"name"`  Email string `form:"email"`}func main() {engine := gin.New()engine.GET("/user/list", func(ctx *gin.Context) {var u Userif err := ctx.BindQuery(&u);err != nil {ctx.JSON(http.StatusBadRequest, err)return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

运行后的请求结果:

curl -X GET "http://localhost:8080/user/list?email=john@163.com&name=john你输入的用户名为:john,邮箱为:john@163.com

绑定HTTP Body参数

我们知道HTTP Body的参数会根据不同Content-Type传不同格式的数据,Gin支持以下几种Content-Type类型的绑定:

JSONXMLTOMLYAMLx-www-form-urlencodedmultipart/form-data

注意HTTP Body的数据只在POST请求时才会进行绑定。

绑定HTTP Body参数可以用Bind()和ShouldBind()方法,这两个方法会根据当前请求的Content-Type类型自动判断请求的类型。

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  stringEmail string}func main() {engine := gin.New()engine.POST("/user/add", func(ctx *gin.Context) {var u Userif err := ctx.Bind(&u); err != nil {ctx.JSON(http.StatusBadRequest, err.Error())return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

如果明确请求数据的类型,也可以直接调用对应类型绑定的方法,比如确定是JSON格式数据的话,可以调用BindJSON()或者ShouldBindJSON():

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  stringEmail string}func main() {engine := gin.New()engine.POST("/user/add", func(ctx *gin.Context) {var u Userif err := ctx.BindJSON(&u); err != nil {ctx.JSON(http.StatusBadRequest, err.Error())return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

对于x-www-form-urlencoded和multipart/form-data,与Qurey参数一样,结构体需要添加form的tag:

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  string `form:"name"`Email string `form:"email"`}func main() {engine := gin.New()engine.POST("/user/add", func(ctx *gin.Context) {var u Userif err := ctx.Bind(&u); err != nil {ctx.JSON(http.StatusBadRequest, err.Error())return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

数据校验

在数据绑定的时候,也可以进行数据校验,这里我们为User结构体的标签添加了required属性,要求这个字段必须要有:

package mainimport ("fmt""net/http""github.com/gin-gonic/gin")type User struct {Name  string `binding:"required"`Email string `binding:"required"`}func main() {engine := gin.New()engine.POST("/user/add", func(ctx *gin.Context) {var u Userif err := ctx.Bind(&u); err != nil {ctx.JSON(http.StatusBadRequest, err.Error())return}fmt.Fprintf(ctx.Writer, "你输入的用户名为:%s,邮箱为:%s\n", u.Name, u.Email)})engine.Run()}

两种方式的对比

相较于直接获取请求参数,请求数据绑定是一种更强大且优雅的参数获取方式,使用这种方式获取参数有以下几个好处:

直接将所有参数绑定到一个结构体中,不需要手动一个个地获取参数。绑定后的参数会自动转换为结构体对应字段的类型,不需要手动对每个参数进行数据类型转换。在进行数据绑定的同时还可以进行数据校验。

小结

直接获取请求参数虽然没有绑定参数那么强大,但对于简单的请求来说,也是够用的,因此,我们可以根据自己的需求,选择对应的方式来获取请求参数。


点击全文阅读


本文链接:http://zhangshiyu.com/post/67852.html

<< 上一篇 下一篇 >>

  • 评论(0)
  • 赞助本站

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

关于我们 | 我要投稿 | 免责申明

Copyright © 2020-2022 ZhangShiYu.com Rights Reserved.豫ICP备2022013469号-1