Gin Quickstart
Gin 使基于 go 语言的一个 web 框架,接口简洁,封装比较优雅,性能表现很好。
Gin 特性
-
快速:路由不使用反射,基于Radix树,内存占用少。
-
中间件:HTTP请求,可先经过一系列中间件处理,例如:Logger,Authorization,GZIP等。中间件机制极大地提高了框架的可扩展性。
-
异常处理:服务始终可用,不会宕机。Gin 可以捕获 panic,并恢复。而且有极为便利的机制处理HTTP请求过程中发生的错误。
-
JSON:Gin可以解析并验证请求的JSON。这个特性对Restful API的开发尤其有用。
-
路由分组:例如将需要授权和不需要授权的API分组,不同版本的API分组。而且分组可嵌套,且性能不受影响。
-
渲染内置:原生支持JSON,XML和HTML的渲染。
Quickstart
- 安装 Gin 前,首先要安装 Go,并做好各种设置。Go 版本要求 1.9 以上。
- 下载并安装 Gin。
$ go get -u github.com/gin-gonic/gin
- 在代码中引入:
import "github.com/gin-gonic/gin"
- 如果需要使用类似
http.StatusOK
的常量,则需引入net/http
。
import "net/http"
- 示例代码:
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
}