教程 > Gin 教程 阅读:72

Gin 教程

Gin 是一个用 Go (Golang) 编写的 web 框架。它是一个类似于 martini 但拥有更好性能的 API 框架,由于 httprouter,速度提高了近 40 倍。如果你是性能和高效的追求者,你会爱上 Gin。

在本节中,我们将介绍 Gin 是什么,它解决了哪些问题,以及它如何帮助你的项目。

或者,如果你已经准备在项目中使用 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。
  • 可扩展性 新建一个中间件非常简单,去查看示例代码吧。

要求

Go1.13及以上版本


安装

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"

开始

首先,创建一个名为main.go的文件

接着将如下代码写入到main.go

package main

import (
    "github.com/gin-gonic/gin"
    "net/http"
)

func main() {
    r := gin.Default()
    //定义路由的GET方法及响应处理函数
    r.GET("/hello", func(c *gin.Context) {
        //将发送的信息封装成JSON发送给浏览器
        c.JSON(http.StatusOK, gin.H{
          "web": "迹忆客",
            //这是我们定义的数据
            "website": "www.jiyik.com",
        })
    })
    r.Run() //默认在本地8080端口启动服务
}

然后,执行 go run main.go 命令来运行代码。在浏览器中输入127.0.0.1:8080/hello 访问,结果如下

go gin 初始化项目


学习前需要准备的知识

在开始本教程之前,需要掌握 Go语言 的知识点。

查看笔记

扫码一下
查看教程更方便