Gin是一個用Golang編寫的HTTP網絡框架。它的特點是類似于Martini的API，性能更好。在golang web開發領域是一個非常熱門的web框架。
啟動一個Gin web服務器
使用下面的命令安裝Gin
go get -u github.com/gin-gonic/gin
在代碼里添加依賴
import "github.com/gin-gonic/gin"
快速啟動一個Gin服務器的代碼如下
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()返回一個Engine對象，調用Engine對象的Run方法會在本機8080端口啟動web服務器。如果不想綁定8080端口或者8080端口已被占用的話，可以給Run方法傳遞你要綁定的端口r.Run(":8081")。代碼中的r.GET就是本文要講解核心內容：路由。
路由
Gin支持http方法: GET, POST, PUT, PATCH, DELETE,HEAD, OPTIONS。分別對應了不同的方法。
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()
}
這些路由方法的第一個參數設置相對地址，第二個方法是訪問該地址時執行的方法。在Gin中叫做handler。handler方法的原型如下。
type HandlerFunc func(*Context)
Gin還可以設置路由前綴。例如有v1/login,v1/logout兩個地址可以使用Gin的Grouping routes功能設置路由前綴。
func main() {
router := gin.Default()
v1 := router.Group("/v1")
{
v1.POST("/login", loginEndpoint)
v1.POST("/logout", logoutEndpoint)
}
router.Run()
}
獲取參數
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")
}
可以看到獲取參數的方法可以分為路由參數、查詢字符串和表單。
路由參數使用c.Param("name")取值。訪問/user/john時會調用/user/:name對應的handler，根據規則當訪問/user/或者/user并不會調用這個hanlder。
訪問/user/john/或者/user/john/send時會調用/user/:name/*action對應的handler。如果沒有對/user/john設置過路由的話，訪問/user/john會重定向到/user/john/。
使用DefaultQuery或者Query獲取查詢字符串中的參數，DefaultQuery在沒有獲取到參數時可以設置一個默認值。在本例中訪問/welcome?firstname=Janelastname=Doe會調用/welcome對應的handler。
獲取表單參數Gin同樣也為我們提供了兩種方法PostForm和DefaultPostForm。和獲取查詢字符串的方法一樣，DefaultPostForm也可以在沒有獲取到參數時設置一個默認值。
Gin的Api總體來說還是很直觀的，例如上文中沒有提到的c.JSON從命名就可以看出會輸出一段JSON。c.String直接輸出字符串。http.StatusOK定義在http包中，這是一個值為200的常量。gin.H不太一樣，這是一個自定義的數據類型map[string]interface{}可以用于返回JSON。
文章出處：基于gin的golang web開發：路由
到此這篇關于基于gin的golang web開發：路由示例詳解的文章就介紹到這了,更多相關gin golang開發路由內容請搜索腳本之家以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持腳本之家！
您可能感興趣的文章:- Gin golang web開發模型綁定實現過程解析
- golang websocket 服務端的實現
- Golang實現web文件共享服務的示例代碼
- golang搭建靜態web服務器的實現方法
- golang基于websocket實現的簡易聊天室程序
- 基于gin的golang web開發之認證利器jwt
