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
  1. 在代码中引入:
import "github.com/gin-gonic/gin"
  1. 如果需要使用类似 http.StatusOK 的常量,则需引入 net/http
import "net/http"
  1. 示例代码:
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
}