目前,基于Go的web框架也可謂是百花齊放了,之所以選擇 gin ,沒其他原因,就只是因為其在github上的star數是最多的,而且僅僅從README看,其文檔也是相當豐富的。
安裝gin
直接使用 go get github.com/gin-gonic/gin 即可。
官方README中提供了非常多的例子。例如最簡單的實例代碼:
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() // listen and serve on 0.0.0.0:8080
}
路由
router := gin.Default() // 默認是帶有Logger和Recovery中間件的
router := gin.New() // 不帶中間件的路由
router.Use(gin.Logger()) // 可以使用這種方式來指明中間件
router.GET("/test", MyMiddleware(), testEndpoint) // 也可以用這種方式給指定路由添加中間件
router.GET("/someGet", getting) // 支持所有Restful的操作
// 帶參數的路由
router.GET("/user/:name", func(c *gin.Context) {
name := c.Param("name")
})
// 參數可選/通配符功能
router.GET("/user/:name/*action", ...)
// 路由分組
v1 := router.Group("/v1")
{
v1.POST("/login", loginEndpoint)
v1.POST("/submit", submitEndpoint)
}
v1.Use(AuthRequired()) {} // 路由分組單獨指定中間件
請求與響應
請求
// 獲取路由參數,假設有路由為"/user/:name"
c.Params.ByName("name")
// 獲取query參數
c.Query("name")
c.DefaultQuery("name", "Guest")
// 獲取表單參數
c.PostForm("name")
c.DefaultPostForm("name")
參數綁定
請求驗證
響應
// 返回簡單的字符串
c.String(200, "pong")
// 返回JSON數據
c.JSON(200, gin.H{
"message": "pong",
})
// 重定向
c.Redirect(http.StatusMovedPermanently, "https://google.com")
中間件
自定義中間件
BasicAuth中間件
異步協程
gin可以借助協程來實現異步任務,但是這時候得手動copy上下文,并且只能是可讀取的。
router.GET("/async", func(c *gin.Context) {
cCp := c.Copy()
go func() {
time.Sleep(5 * time.Second)
log.Println("Done! in path" + cCp.Request.URL.Path)
}()
})
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
您可能感興趣的文章:- 使用Golang簡單實現七牛圖片處理API
- Laravel框架執行原生SQL語句及使用paginate分頁的方法
- Flask框架Flask-Login用法分析
- Python的Flask框架及Nginx實現靜態文件訪問限制功能
- PHP框架Laravel插件Pagination實現自定義分頁
- 使用Nginx+uWsgi實現Python的Django框架站點動靜分離
- golang API開發過程的中的自動重啟方式(基于gin框架)