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基本路由的资料请关注其它相关文章！