## 1. 介绍 Gin 是一个用 Golang编写的 高性能的web 框架, 由于http路由的优化,速度提高了近 40 倍。 Gin的特点就是封装优雅、API友好。 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。 - 可扩展性 新建一个中间件非常简单。 ## 2.下载并安装 - 首先需要安装golang的环境(略) - 安装gin ```go go get -u github.com/gin-gonic/gin ``` ## 3.简单的例子 - 新建main.go文件 ```go package main // 导入gin包 import "github.com/gin-gonic/gin" // 入口函数 func main() { // 初始化一个http服务对象 r := gin.Default() // 设置一个get请求的路由,url为/hello, 处理函数(或者叫控制器函数)是一个闭包函数。 r.GET("/hello", func(c *gin.Context) { // 通过请求上下文对象Context, 直接往客户端返回一个json c.JSON(200, gin.H{ "message": "hello world", }) }) r.Run() // 监听并在 0.0.0.0:8080 上启动服务 } ``` - 访问localhost:8080/hello - 响应 ```json { "message": "hello world" } ``` - 自定义访问的address和port ```go package main import ( "fmt" "github.com/gin-gonic/gin" ) //定义address和port const ( address string = "0.0.0.0" port int = 80 ) func main() { // 初始化一个http服务对象 r := gin.Default() // 设置一个get请求的路由,url为/hello, 处理函数(或者叫控制器函数)是一个闭包函数。 r.GET("/hello", func(c *gin.Context) { // 通过请求上下文对象Context, 直接往客户端返回一个json c.JSON(200, gin.H{ "message": "hello world", }) }) r.Run(fmt.Sprintf("%s:%d", address, port)) // 监听并在 0.0.0.0:80 上启动服务 } ``` - 访问localhost/hello - 响应 ```json { "message": "hello world" } ``` ## 4.小结 1. 使用gin可以快速的实现一个高性能的http服务。 2. gin支持中间件,路由组,json校验,内容渲染,json校验错误管理等特性,扩展性高。 3. gin不提供orm组件、配置管理等,如果项目中需要进行数据持久化等操作需要引入相关的包,如:gorm,xorm等。 > 更多内容请关注我的博客[SOCKSTACk](https://www.sockstack.cn)