golang微服务框架基础Gin基本路由使用详解
作者:枫少文
概述
路由是自定义url地址执行指定的函数,良好的路由定义可以对seo起到很好的效果。
1. 基本路由
gin框架封装了http库,提供了 GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS 这些http请求方式。
使用 router.method()
来绑定路由
func (group *RouterGroup) METHOD(relativePath string, handlers ...HandlerFunc) IRoutes
router := gin.Default() router.GET("/get", func(c *gin.Context) { c.JSON(200, gin.H{"message": "get方法"}) }) router.POST("/post", func(c *gin.Context) { c.JSON(200, gin.H{"message": "post方法"}) }) router.PUT("/put", func(c *gin.Context) { c.JSON(200, gin.H{"message": "put方法"}) }) router.DELETE("/delete", func(c *gin.Context) { c.JSON(200, gin.H{"message": "delete"}) }) router.PATCH("/patch", func(c *gin.Context) { c.JSON(200, gin.H{"message": "patch"}) }) router.HEAD("/head", func(c *gin.Context) { c.JSON(200, gin.H{"message": "head"}) }) router.OPTIONS("/options", func(c *gin.Context) { c.JSON(200, gin.H{"message": "options"}) }) router.Run(":9999")//指定端口 localhost:9999
2. 路由参数
获取URL路径全部参数
以/为分割符,每个参数以“:”为参数表示动态变量,会自动绑定到路由对应的参数上
路由规则:[:]表示可以不用匹配
比如:
http://localhost:8080/user/李四/20/北京/男 将匹配 “http://localhost:8080/user/:name/:age/:address/:sex”
上面的这个链接中,可以通过向上面讲的
使用/user/:name/:age/:address/:sex来分别匹配李四、20、北京、男
c.Params("key")
//http://localhost:8080/user/李四/20/北京/男 router.GET("/user/:name/:age/:address/:sex", func(c *gin.Context) { //打印URL中所有参数 //"[{name 李四} {age 20} {address 北京} {sex 男}]\n" c.JSON(http.StatusOK, fmt.Sprintln(c.Params)) })
注意:但是不会匹配 /user/ 或者 /user
访问:http://localhost:8080/user/李四/20/北京/男
结果:
"[{name 李四} {age 20} {address 北京} {sex 男}]\n"
获取URL路径单个参数
使用gin.Context对象的Param(key)方法获取某一个key的值,方法声明如下:
//http://localhost:8080/login/15949629528/123456 router.GET("/login/:name/:password", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{ //{ name: "15949629528", password: "123456" } "name": c.Param("name"), "password": c.Param("password"), }) })
访问:http://localhost:8080/login/15949629528/123456
结果:
{ name: "15949629528", password: "123456" }
获取URL中指定的参数
GET、POST请求
获取URL中路径值和获取参数不一样
比如:
http://localhost:8080/login?name=张三&password=123456
可以使用接下在的方法获取请求参数name、password的值。
//返回URL中key的值 func (c *Context) Query(key string) string
//GET请求 router.GET("/login", func(c *gin.Context) { //{ name: "张三", password: "123456" } c.JSON(http.StatusOK, gin.H{ "name": c.Query("name"), "password": c.Query("password"), }) }) //POST请求 router.POST("/login", func(c *gin.Context) { //{"name":"张三","password":"123456"} c.JSON(http.StatusOK, gin.H{ "name": c.Query("name"), "password": c.Query("password"), }) })
访问:http://localhost:8080/login?name=张三&password=123456
输出内容如下:
{ name: "张三", password: "123456" }
获取指定默认值的参数的
带有默认值的接收 GET、POST请求
gin框架当然也想到了这么一点,gin.Context.DefaultQuery()
方法,允许你指定接收的参数名,以及没有接收到该参数值时,设置的默认值,声明如下:
func (c *Context) DefaultQuery(key, defaultValue string) string
只有当请求没有携带key,那么此时的默认值就会生效。其他情况,默认值不生效。即使URL中的该key的值为空,那么也不会启用默认值,获取的值就是空。
注意,这是获取URL中的参数值
//GET请求 router.GET("/user", func(c *gin.Context) { //{ name: "张三", password: "123456" } c.JSON(http.StatusOK, gin.H{ "name": c.DefaultQuery("name", "默认张三"), "password": c.DefaultQuery("password", "默认密码"), }) }) //POST请求 router.POST("/user", func(c *gin.Context) { //{"name":"张三","password":"默认密码"} c.JSON(http.StatusOK, gin.H{ "name": c.DefaultQuery("name", "默认张三"), "password": c.DefaultQuery("password", "默认密码"), }) })
访问:http://localhost:8080/user?password=
输出内容如下:
{ name: "默认张三", password: "默认密码" }
以上就是golang微服务框架Gin基本路由使用详解的详细内容,更多关于Gin基本路由的资料请关注脚本之家其它相关文章!