目录
- 前言
- 正文
- 一、定义 GET, POST, PUT, PATCH, DELETE 和 OPTIONS 的接口
- 二、解析 path 中的参数
- 结尾
前言
Gin 是使用纯 Golang 语言实现的 HTTP Web 框架,Gin 的接口设计简洁,性能极高,现在被广泛使用。上一篇文章介绍了 Gin 的基本使用方式,今天我们详细看一看 Gin 在接口定义和参数解析方面的内容。
正文
一、定义 GET, POST, PUT, PATCH, DELETE 和 OPTIONS 的接口
package main import "github.com/gin-gonic/gin" func main() { // 创建一个默认的 gin 路由器 router := gin.Default() // 定义一个Get类型的服务接口 router.GET("/someGet", getting) // 定义一个Post类型的服务接口 router.POST("/somePost", posting) // 定义一个Put类型的服务接口 router.PUT("/somePut", putting) // 定义一个DELETE类型的服务接口 router.DELETE("/someDelete", deleting) // 定义一个Patch类型的服务接口 router.PATCH("/somePatch", patching) // 定义一个Head类型的服务接口 router.HEAD("/someHead", head) // 定义一个Options类型的服务接口 router.OPTIONS("/someOptions", options) // 启动服务,默认监听8080端口,或者通过PORT环境变量设置 router.Run() }
通过简单的编码,基于 Gin 的服务器就支持了多种类型请求的服务接口。另外,在服务启动的时候,我们也可以通过直接指明端口的方式来设置服务监听的端口,比如下面的方式:
router.Run(":3001")
上面的语句,我们可以知道服务监听了 3001 端口。
二、解析 path 中的参数
下面介绍几种 path 中存在参数时,如何解析的情况,具体请看下面的代码示例。
package main import "github.com/gin-gonic/gin" func main() { router := gin.Default() // 可以匹配 /user/john,但是不能匹配 /user/ 和 /user 请求 router.GET("/user/:name", func(c *gin.Context) { name := c.Param("name") c.String(http.StatusOK, "Hello %s", name) }) // 可以匹配 /user/john/ 和 /user/john/send router.GET("/user/:name/*action", func(c *gin.Context) { name := c.Param("name") action := c.Param("action") message := name + " is " + action c.String(http.StatusOK, message) }) // 对于每个匹配的请求,上下文将保存路由定义 router.POST("/user/:name/*action", func(c *gin.Context) { c.FullPath() == "/user/:name/*action" // true }) router.Run(":8080") }
可以看出,解析 path 中的参数时需要注意的细节还是非常多的。
结尾
好了,今天关于 Gin 在接口定义和参数解析方面的内容就介绍完了,后续内容敬请期待,感谢!
作者简介:大家好,我是 Data-Mining(liuzhen007),是一位典型的音视频技术爱好者,同时也是CSDN博客专家、华为云享专家(共创编辑)、InfoQ 签约作者,欢迎关注我分享更多干货!