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

Posted on by

概述

路由是自定義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基本路由的資料請關註WalkonNet其它相關文章！

推薦閱讀：