Gin框架系列之快速入门

一、什么是Gin

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。

• 可扩展性

新建一个中间件非常简单，去查看示例代码吧。

二、快速入门

1、安装 

go get github.com/gin-gonic/gin

2、使用

package main

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

func main() {
    //返回一个engine的实例
    router := gin.Default()
    // GET方法
    router.GET("/hello", func(context *gin.Context) {
        context.JSON(http.StatusOK, gin.H{
            "message": "Hello World!",
        })
    })
    //启动服务，监听8000端口
    _ = router.Run(":8000")
}

3、常用方法

Gin框架中包含也包含常用的http请求方法：

func main() {
    // Creates a gin router with default middleware:
    // logger and recovery (crash-free) middleware
    router := gin.Default()

    router.GET("/someGet", getting)
    router.POST("/somePost", posting)
    router.PUT("/somePut", putting)
    router.DELETE("/someDelete", deleting)
    router.PATCH("/somePatch", patching)
    router.HEAD("/someHead", head)
    router.OPTIONS("/someOptions", options)

    // By default it serves on :8080 unless a
    // PORT environment variable was defined.
    router.Run()
    // router.Run(":3000") for a hard coded port
}