Gin 学习之安装和快速启动

时间:2022-07-23
本文章向大家介绍Gin 学习之安装和快速启动,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

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"}