前言

• Gin 中文文档：Gin
• 简单的使用案例：RealWord

Gin 的特点：

• 快速：基于 Radix 树的路由，小内存占用。没有反射。可预测的 API 性能
• 支持中间件：传入的 HTTP 请求可以由一系列中间件和最终操作来处理。 例如：Logger，Authorization，GZIP，最终操作 DB
• 路由组：更好地组织路由。是否需要授权，不同的 API 版本

安装 Gin

1. 下载并安装 gin

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

2. 引用 gin

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

3. 使用 gin ，创建并运行 example.go 文件

package main

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

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(200, gin.H{
      "message": "pong",
    })
  })
  router.Run() // 监听并在 0.0.0.0:8080 上启动服务，默认监听的端口：8080
}

路由组

• 使用 router.Group 方式实现路由分组
• 应用：API 多版本

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

  // 简单的路由组: v1
  {
    v1 := router.Group("/v1")
    v1.POST("/login", loginEndpoint)
    v1.POST("/submit", submitEndpoint)
    v1.POST("/read", readEndpoint)
  }

  // 简单的路由组: v2
  {
    v2 := router.Group("/v2")
    v2.POST("/login", loginEndpoint)
    v2.POST("/submit", submitEndpoint)
    v2.POST("/read", readEndpoint)
  }

  router.Run(":8080")
}

自定义 HTTP 配置

两种方式实现：http.ListenAndServe() 、或者指定 Server 参数

import "net/http"

func main() {
  router := gin.Default()
  http.ListenAndServe(":8080", router)
}

或者：

import "net/http"

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

  s := &http.Server{
    Addr:           ":8080",
    Handler:        router,
    ReadTimeout:    10 * time.Second,
    WriteTimeout:   10 * time.Second,
    MaxHeaderBytes: 1 << 20,
  }
  s.ListenAndServe()
}

版权所有

版权归属：haipeng-lin

许可证：署名 4.0 国际 (CC-BY-4.0)