01
概念
Gin 是一个用 Go (Golang) 编写的 web 框架。它是一个类似于 martini 但拥有更好性能的 API 框架, 由于 httprouter,速度提高了近 40 倍。
特性:
- 快速
基于 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。 - 可扩展性
新建一个中间件非常简单。
了解更多,请访问官方文档:
https://gin-gonic.com/zh-cn/docs/
02
安装
- 创建项目目录执行命令:
make ~/lesson1 && cd $_
- go mod init 初始化执行命令:
go mod init lesson1
- go get 安装 gin使用 go 工具 go get 安装 gin
go get -u github.com/gin-gonic/gin
03
快速启动
Gin 框架已安装完成,我们通过程序代码,快速启动一个 gin 程序:
完整代码:
代码讲解:
- 创建一个 gin 默认 engine 实例。
- 创建一个普通路由,GET 请求指定路径,响应 JSON 格式的返回结果。
- 监听端口,并启动 Server 服务。
客户端访问:
curl -X GET http://localhost:8081/ping {"message":"pong"}