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

  1. 安装 Gin 前,首先要安装 Go,并做好各种设置。Go 版本要求 1.9 以上。
  2. 下载并安装 Gin。

    $ go get -u github.com/gin-gonic/gin
    
  3. 在代码中引入:

    import "github.com/gin-gonic/gin"
    
  4. 如果需要使用类似 http.StatusOK 的常量,则需引入 net/http

    import "net/http"
    
  5. 示例代码:

    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
    }