Gin框架 | 青训营

1.介绍

Gin 是一个用 Go (Golang) 编写的 Web 框架。 它具有类似 martini 的 API，性能要好得多，多亏了 httprouter，速度提高了 40 倍。 如果您需要性能和良好的生产力，您一定会喜欢 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.安装

要求

• Go 1.13 及以上版本

安装 要安装 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"

快速入门示例 首先，创建一个名为 example.go 的文件

$ touch example.go

接下来, 将如下的代码写入 example.go 中：

package main

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

func main() {
    //创建一个默认路由
    r := gin.Default()
    //配置路由
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })
    r.Run() // 监听并在 0.0.0.0:8080 上启动服务
}

然后, 执行 go run example.go 命令来运行代码：

# 运行 example.go 并且在浏览器中访问 HOST_IP:8080/ping
$ go run example.go

3.Golang程序热加载

所谓热加载就是当我们对代码进行修改时，程序能够自动重新加载并执行，这在我们开发中 是非常便利的，可以快速进行代码测试，省去了每次手动重新编译 。
beego 中我们可以使用官方给我们提供的 bee 工具来热加载项目，但是 gin 中并没有官方提 供的热加载工具，这个时候我们要实现热加载就可以借助第三方的工具。 工具1（推荐）:github.com/gravityblas…

$ go get github.com/pilu/fresh
$ fresh

工具2 : github.com/codegsta/gi…

$ go get -u github.com/codegangsta/gin
$ gin run main.go

4.Gin框架中的路由

4.1 路由概述

路由(Routing)是由一个 URI(或者叫路径)和一个特定的 HTTP 方法(GET、POST 等) 组成的，涉及到应用如何响应客户端对某个网站节点的访问。 RESTful API 是目前比较成熟的一套互联网应用程序的 API 设计理论，所以我们设计我们的路 由的时候建议参考 RESTful API 指南。 RESTful 架构中，每个网址代表一种资源，不同的请求方式表示执行不同的操作: