golang微服務框架基礎Gin基本路由使用詳解

更新時間：2021年11月18日 10:59:28 作者：楓少文

這篇文章主要為大家介紹了golang微服務框架Gin基本路由的使用示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步

概述

路由是自定義url地址執(zhí)行指定的函數，良好的路由定義可以對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路徑全部參數

以/為分割符，每個參數以“：”為參數表示動態(tài)變量，會自動綁定到路由對應的參數上
路由規(guī)則:[:]表示可以不用匹配

比如：

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", "默認密碼"),
	})
})