Go学习笔记 - WEB框架Gin

2019-12-31

全文 ≈ 832字 | 预计阅读时长 4分钟

Gin 是一个用 Go (Golang) 编写的 HTTP web 框架。它是一个类似于 martini 但拥有更好性能的 API 框架, 由于 httprouter，速度提高了近 40 倍。

1.有哪些优点

较高的性能（Golang WEB框架比对数据）

简单易用的中间件

使用了性能高可扩展的HTTP路由httprouter

社区长期有着很高的活跃度

Github星星多（Orz）

…等

2.安装/更新

安装

1	$ go get github.com/gin-gonic/gin

更新

1	$ go get -u github.com/gin-gonic/gin

3.Hello World

package main

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

func main() {
    // 框架
    g := gin.Default()

    // 路由
    g.GET("/t", test)

    // 服务端口
    g.Run(":4000")
}

func test(c *gin.Context) {
    c.String(200, "Hallo!")
}

运行

1	$ go run main.go

访问 http://127.0.0.1:4000/t ，页面输出Hallo!。

4.路由

Gin支持的路由方式和大部分主流框架基本一致。

func main() {
    g := gin.Default()

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

    g.Run(":4000")
}

Gin同样也支持路由参数，不过不支持路由正则表达式。

func main() {
    g := gin.Default()

    // 此 handler 只能匹配 /user/{PARAM}
    g.GET("/user/:name", func(c *gin.Context) {
        name := c.Param("name")
        c.String(http.StatusOK, "Hello %s", name)
    })

    // 此 handler 会匹配 /user/{PARAM}/ 和 /user/{PARAM}/{ACTION_2}
    // 如果访问 /user/{PARAM}，在没有 "/user/:name" 路由的情况下，会重定向至 /user/{PARAM}/ 匹配当前路由。
    g.GET("/user/:name/*action", func(c *gin.Context) {
        name := c.Param("name")
        action := c.Param("action")
        message := name + " is " + action
        c.String(http.StatusOK, message)
    })

    g.Run(":4000")
}

5.路由组

Gin在路由分组上的做法和其他框架也都是一致的，再次体现了Gin简单易用极容易上手的优点。

func main() {
    g := gin.Default()

    userGroup := g.Group("/user")
    {
        userGroup.POST("/login", ctrls.Login)
        userGroup.POST("/logout", ctrls.Logout)
    }

    reportGroup := g.Group("/report")
    {
        reportGroup.POST("/revenue", ctrls.RevenueReport)
        reportGroup.POST("/cost", ctrls.CostReport)
    }

    g.Run(":4000")
}

6.中间件

Gin的中间件分为：全局，路由组，路由级别。

func main() {
    g := gin.Default()

    // 全局中间件
    g.Use(middleware)

    // 路由组中间件
    routerGroup := g.Group("/user", middleware)
    {
        // 路由中间件
        routerGroup.GET("/login", middleware, ctrls.Login)
    }

    g.Run(":4000")
}

7.参数

Gin如何获取请求参数？下面的简单例子：

func main() {
    g := gin.Default()

    // URL参数
    // URL：/[email protected]
    g.GET("/user", func(c *gin.Context) {
        // 使用 DefaultQuery 或者 Query
        email := c.DefaultQuery("email", "default value")
        email = c.Query("email")

        c.String(http.StatusOK, "Hallo, %s", email)
    })

    // POST参数
    g.POST("/user/login", func(c *gin.Context) {
        // 使用 DefaultPostForm 或者 PostForm
        email := c.PostForm("email")
        email = c.DefaultPostForm("email", "default value")

        c.String(http.StatusOK, "Hallo, %s", email)
    })

    g.Run(":4000")
}

最后

Gin支持的操作还有很多，比如：数据绑定、数据验证、上传文件、静态资源嵌入等。

Gin没有提供的组件也有很多，比如：ORM、Console、日志滚动分割等。

仁者见仁智者见智，Gin专注做HTTP WEB框架的核心，更多扩展需要开发人员自己去选择，组件化的设计无疑是好的。