1、gin介绍

1.1 gin 是什么？

Gin 是一个用 Go (Golang) 编写的 HTTP web 框架。 它是一个类似于 martini 但拥有更好性能的 API 框架，由于

httprouter，速度提高了近 40 倍。如果你需要极好的性能，使用 Gin 吧。

https://github.com/go-martini/martini

https://github.com/julienschmidt/httprouter

1.2 gin优点？

• 快速

  基于 Radix 树的路由，小内存占用。没有反射。可预测的 API 性能。

• 支持中间件

  传入的 HTTP 请求可以由一系列中间件和最终操作来处理。例如：Logger，Authorization，GZIP，最终操作

  DB。

• Crash 处理

  Gin 可以 catch 一个发生在 HTTP 请求中的 panic 并 recover 它。这样，你的服务器将始终可用。例如，你可

  以向 Sentry 报告这个 panic！

• JSON 验证

  Gin 可以解析并验证请求的 JSON，例如检查所需值的存在。

• 路由组

  更好地组织路由。是否需要授权，不同的 API 版本…… 此外，这些组可以无限制地嵌套而不会降低性能。

• 错误管理

  Gin 提供了一种方便的方法来收集 HTTP 请求期间发生的所有错误。最终，中间件可以将它们写入日志文件，

  数据库并通过网络发送。

• 内置渲染

  Gin 为 JSON，XML 和 HTML 渲染提供了易于使用的 API。

• 可扩展性

  新建一个中间件非常简单。

1.3 gin特性？

Gin v1 稳定的特性：

• 零分配路由。
• 仍然是最快的 http 路由器和框架。
• 完整的单元测试支持。
• 实战考验。
• API 冻结，新版本的发布不会破坏你的代码。

1.4 基准测试

Gin 使用了自定义版本的 HttpRouter。

查看所有基准测试：https://github.com/gin-gonic/gin/blob/master/BENCHMARKS.md

Benchmark name	(1)	(2)	(3)	(4)
BenchmarkGin_GithubAll	30000	48375	0	0
BenchmarkAce_GithubAll	10000	134059	13792	167
BenchmarkBear_GithubAll	5000	534445	86448	943
BenchmarkBeego_GithubAll	3000	592444	74705	812
BenchmarkBone_GithubAll	200	6957308	698784	8453
BenchmarkDenco_GithubAll	10000	158819	20224	167
BenchmarkEcho_GithubAll	10000	154700	6496	203
BenchmarkGocraftWeb_GithubAll	3000	570806	131656	1686
BenchmarkGoji_GithubAll	2000	818034	56112	334
BenchmarkGojiv2_GithubAll	2000	1213973	274768	3712
BenchmarkGoJsonRest_GithubAll	2000	785796	134371	2737
BenchmarkGoRestful_GithubAll	300	5238188	689672	4519
BenchmarkGorillaMux_GithubAll	100	10257726	211840	2272
BenchmarkHttpRouter_GithubAll	20000	105414	13792	167
BenchmarkHttpTreeMux_GithubAll	10000	319934	65856	671
BenchmarkKocha_GithubAll	10000	209442	23304	843
BenchmarkLARS_GithubAll	20000	62565	0	0
BenchmarkMacaron_GithubAll	2000	1161270	204194	2000
BenchmarkMartini_GithubAll	200	9991713	226549	2325
BenchmarkPat_GithubAll	200	5590793	1499568	27435
BenchmarkPossum_GithubAll	10000	319768	84448	609
BenchmarkR2router_GithubAll	10000	305134	77328	979
BenchmarkRivet_GithubAll	10000	132134	16272	167
BenchmarkTango_GithubAll	3000	552754	63826	1618
BenchmarkTigerTonic_GithubAll	1000	1439483	239104	5374
BenchmarkTraffic_GithubAll	100	11383067	2659329	21848
BenchmarkVulcan_GithubAll	5000	394253	19894	609

(1)、在一定的时间内实现的总调用数，越高越好

(2)、单次操作耗时（ns/op），越低越好

(3)、堆内存分配 （B/op）, 越低越好

(4)、每次操作的平均内存分配次数（allocs/op），越低越好

1.5 参考

Gin HitHub：https://github.com/gin-gonic/gin/

使用例子：https://github.com/gin-gonic/examples

1.6 用户

使用 Gin web 框架的知名项目：

• gorush：Go 编写的通知推送服务器。
• fnproject：原生容器，云 serverless 平台。
• photoprism：由 Go 和 Google TensorFlow 提供支持的个人照片管理工具。
• krakend：拥有中间件的超高性能 API 网关。
• picfit：Go 编写的图像尺寸调整服务器。
• gotify：使用实时 web socket 做消息收发的简单服务器。
• cds：企业级持续交付和 DevOps 自动化开源平台。

2、gin安装

2.1 要求

Go 1.13 及以上版本

2.2 安装

要安装 Gin 软件包，需要先安装 Go 并设置 Go 工作区。

1、下载并安装 gin：

$ go get -u github.com/gin-gonic/gin

2、将 gin 引入到代码中：

import "github.com/gin-gonic/gin"

3、（可选）如果使用诸如 http.StatusOK 之类的常量，则需要引入 net/http 包：

import "net/http"