Gin是一個(gè)用Golang編寫(xiě)的HTTP網(wǎng)絡(luò)框架。它的特點(diǎn)是類(lèi)似于Martini的API，性能更好。在golang web開(kāi)發(fā)領(lǐng)域是一個(gè)非常熱門(mén)的web框架。

啟動(dòng)一個(gè)Gin web服務(wù)器

使用下面的命令安裝Gin

go get -u github.com/gin-gonic/gin

在代碼里添加依賴(lài)

import "github.com/gin-gonic/gin"

快速啟動(dòng)一個(gè)Gin服務(wù)器的代碼如下

package main

import "github.com/gin-gonic/gin"

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run()
}

核心api gin.Default()返回一個(gè)Engine對(duì)象，調(diào)用Engine對(duì)象的Run方法會(huì)在本機(jī)8080端口啟動(dòng)web服務(wù)器。如果不想綁定8080端口或者8080端口已被占用的話(huà)，可以給Run方法傳遞你要綁定的端口r.Run(":8081")。代碼中的r.GET就是本文要講解核心內(nèi)容：路由。

路由

Gin支持http方法: GET, POST, PUT, PATCH, DELETE,HEAD, OPTIONS。分別對(duì)應(yīng)了不同的方法。

func main() {
	router := gin.Default()

	router.GET("/someGet", getting)
	router.POST("/somePost", posting)
	router.PUT("/somePut", putting)
	router.DELETE("/someDelete", deleting)
	router.PATCH("/somePatch", patching)
	router.HEAD("/someHead", head)
	router.OPTIONS("/someOptions", options)

	router.Run()
}

這些路由方法的第一個(gè)參數(shù)設(shè)置相對(duì)地址，第二個(gè)方法是訪(fǎng)問(wèn)該地址時(shí)執(zhí)行的方法。在Gin中叫做handler。handler方法的原型如下。

type HandlerFunc func(*Context)

Gin還可以設(shè)置路由前綴。例如有v1/login,v1/logout兩個(gè)地址可以使用Gin的Grouping routes功能設(shè)置路由前綴。

func main() {
	router := gin.Default()

	v1 := router.Group("/v1")
	{
		v1.POST("/login", loginEndpoint)
		v1.POST("/logout", logoutEndpoint)
	}

	router.Run()
}

獲取參數(shù)

func main() {
	router := gin.Default()

	router.GET("/user/:name", func(c *gin.Context) {
		name := c.Param("name")
		c.String(http.StatusOK, "Hello %s", name)
	})

	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.GET("/welcome", func(c *gin.Context) {
		firstname := c.DefaultQuery("firstname", "Guest")
		lastname := c.Query("lastname")

		c.String(http.StatusOK, "Hello %s %s", firstname, lastname)
	})
	
	router.POST("/form_post", func(c *gin.Context) {
		message := c.PostForm("message")
		nick := c.DefaultPostForm("nick", "anonymous")

		c.JSON(200, gin.H{
			"status": "posted",
			"message": message,
			"nick":  nick,
		})
	})

	router.Run(":8080")
}

可以看到獲取參數(shù)的方法可以分為路由參數(shù)、查詢(xún)字符串和表單。

路由參數(shù)使用c.Param("name")取值。訪(fǎng)問(wèn)/user/john時(shí)會(huì)調(diào)用/user/:name對(duì)應(yīng)的handler，根據(jù)規(guī)則當(dāng)訪(fǎng)問(wèn)/user/或者/user并不會(huì)調(diào)用這個(gè)hanlder。

訪(fǎng)問(wèn)/user/john/或者/user/john/send時(shí)會(huì)調(diào)用/user/:name/*action對(duì)應(yīng)的handler。如果沒(méi)有對(duì)/user/john設(shè)置過(guò)路由的話(huà)，訪(fǎng)問(wèn)/user/john會(huì)重定向到/user/john/。

使用DefaultQuery或者Query獲取查詢(xún)字符串中的參數(shù)，DefaultQuery在沒(méi)有獲取到參數(shù)時(shí)可以設(shè)置一個(gè)默認(rèn)值。在本例中訪(fǎng)問(wèn)/welcome?firstname=Jane&lastname=Doe會(huì)調(diào)用/welcome對(duì)應(yīng)的handler。

獲取表單參數(shù)Gin同樣也為我們提供了兩種方法PostForm和DefaultPostForm。和獲取查詢(xún)字符串的方法一樣，DefaultPostForm也可以在沒(méi)有獲取到參數(shù)時(shí)設(shè)置一個(gè)默認(rèn)值。

Gin的Api總體來(lái)說(shuō)還是很直觀(guān)的，例如上文中沒(méi)有提到的c.JSON從命名就可以看出會(huì)輸出一段JSON。c.String直接輸出字符串。http.StatusOK定義在http包中，這是一個(gè)值為200的常量。gin.H不太一樣，這是一個(gè)自定義的數(shù)據(jù)類(lèi)型map[string]interface{}可以用于返回JSON。

文章出處：基于gin的golang web開(kāi)發(fā)：路由

到此這篇關(guān)于基于gin的golang web開(kāi)發(fā)：路由示例詳解的文章就介紹到這了,更多相關(guān)gin golang開(kāi)發(fā)路由內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論