作者:誓言俱乐部 | 来源:互联网 | 2023-07-30 12:21
简介
Gin 是一个基于 Go 语言编写的 Web 框架,与 martini 框架类似,但拥有更好的性能,借助高性能的 httprouter,速度提升了近 40 倍。如果你追求高性能和开发效率,你会爱上 Gin 框架。
开始介绍 Gin 框架的使用之前,我们先来简单看一下它的特性和优势
官方文档:
https://gin-gonic.com/zh-cn/docs/
功能特性
快速
- 基于 Radix 树(一种更节省空间的 Trie 树结构)的路由,占用内存更少;
- 没有反射;
- 可预测的 API 性能。
内置路由器
开箱即用的路由器功能,不需要做任何配置即可使用。
支持中间件
传入的 HTTP 请求可以经由一系列中间件和最终操作来处理,例如 Logger、Authorization、GZIP 以及最终的 DB 操作。
Crash 处理
Gin 框架可以捕获一个发生在 HTTP 请求中的 panic 并 recover 它,从而保证服务器始终可用。此外,你还可以向 Sentry 报告这个 panic!
JSON 验证
Gin 框架可以解析并验证 JSON 格式的请求数据,例如检查某个必须值是否存在。
路由群组
支持通过路由群组来更好地组织路由,例如是否需要授权、设置 API 的版本等,此外,这些群组可以无限制地嵌套而不会降低性能。
API 冻结
支持 API 冻结,新版本的发布不会破坏已有的旧代码。
错误管理
Gin 框架提供了一种方便的机制来收集 HTTP 请求期间发生的所有错误,并且最终通过中间件将它们写入日志文件、数据库或者通过网络发送到其它系统。
内置渲染
Gin 框架提供了简单易上手的 API 来返回 JSON、XML 或者 HTML 格式响应。
可扩展性
我们将会在后续示例代码中看到 Gin 框架非常容易扩展。
易于测试
Gin 框架提供了完整的单元测试套件。
知名项目
以下知名项目都是使用 Gin 框架开发的:
- gorush:Go 编写的通知推送服务器。
- fnproject:容器原生,云 serverless 平台。
- photoprism:基于 Go 和 Google TensorFlow 实现的个人照片管理工具。
- krakend:拥有中间件的超高性能 API 网关。
- picfit:Go 编写的图像尺寸调整服务器。
- gotify:基于 WebSocket 进行实时消息收发的简单服务器。
- cds:企业级持续交付和 DevOps 自动化开源平台。
快速入门
下载安装:
go get github.com/gin-gonic/gin
示例:
package main
import "github.com/gin-gonic/gin"
func Hello(g *gin.Context) {
g.String(200, "hello,%s", "Psych")
}
func main() {
e := gin.Default()
e.GET("/", Hello)
e.Run()
}
浏览器输入localhost:8080
查看结果: