Gin框架的大致使用方法（详细）

1、在gin框架中文文档是这么介绍的

Gin 是一个用 Go (Golang) 编写的 web 框架。 它是一个类似于 martini 但拥有更好性能的 API 框架，由于 httprouter，速度提高了近 40 倍。 如果你是性能和高效的追求者，你会爱上 Gin。两款Web框架相比较，Gin自己说他比Martini要强很多。

2、Gin的基本使用方法

首先在项目终端下载安装gin包：

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

举一个简单的例子：

package main

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

func main() {
    //Default返回一个默认的路由引擎
    r := gin.Default()
    r.GET("/ping", func(c *gin.Context) { // /ping是路由
        //输出json结果给调用方
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })
  r.Run(":8081") // 可以从本地的127.0.0.1:8081访问，不填的话，默认是8080端口
}

go run main.go 运行程序，打开浏览器访问http://127.0.0.1:8081/ping页面，最终显示：

{"message":"pong"} // 这就是返回给前端的数据

3、Gin框架中的路由使用

gin路由，路由的基本使用，按路由组分组处理请求

package main

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

// gin的helloWorld

func main() {
   // 1.创建路由
   r := gin.Default()
   // 路由组1 ，处理GET请求
   v1 := r.Group("api/v1")
   // {} 是书写规范
   {
      v1.GET("/register", register)
      v1.GET("login", login)
   }
   v2 := r.Group("api/v2")
   {
      v2.POST("/register", register)
      v2.POST("/login", login)
   }
   r.Run(":8000") // 开启端口在8000
}

func login(c *gin.Context) {
   name := c.DefaultQuery("name", "jack")
   c.String(http.StatusOK, fmt.Sprintf("hello %s\n", name))
}

func register(c *gin.Context) {
   name := c.DefaultQuery("name", "lily")
   c.String(http.StatusOK, fmt.Sprintf("hello %s\n", name))
}

4、gin中的数据绑定

gin数据解析和绑定（JSON举例）

package main

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

// 定义接收数据的结构体
type Login struct {
   // binding:"required"修饰的字段，若接收为空值，则报错，是必须字段
   User    string `json:"user" binding:"required"`
   Pssword string `json:"password" binding:"required"`
}

func main() {
   // 1.创建路由
   r := gin.Default()
   // JSON绑定
   r.POST("loginJSON", func(c *gin.Context) {
      // new结构体，给结构体分配内存
     login := new(Login)
      // 将request的body中的数据，自动按照json格式解析到结构体
      if err := c.ShouldBindJSON(&login); err != nil {
         // 返回错误信息
         // gin.H封装了生成json数据的工具
         c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
         return
      }
      c.JSON(http.StatusOK, gin.H{"status": "200"})
   })
   r.Run(":8000")
}

5、gin的中间件使用

next()方法!

func myMiddleWare() gin.HandlerFunc {
	return func(ctx *gin.Context) {
		fmt.Println("before")
		ctx.Next()
		fmt.Println("after")
	}
}
// Next()函数相当于一个分割线，在Next()函数之前的在Handler之前执行，Next()函数之后的在Handler之后执行

Gin中间件

// 定义程序计时中间件，然后定义2个路由，执行函数后应该打印统计的执行时间，如下：
package main

import (
    "fmt"
    "time"

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

// 定义中间
func myTime(c *gin.Context) {
    start := time.Now()
    c.Next()
    // 统计时间
    since := time.Since(start)
    fmt.Println("程序用时：", since)
}

func main() {
    // 1.创建路由
    // 默认使用了2个中间件Logger(), Recovery()
    r := gin.Default()
    // 注册中间件
    r.Use(myTime)
    // {}为了代码规范
    shoppingGroup := r.Group("/shopping")
    {
        shoppingGroup.GET("/index", shopIndexHandler)
        shoppingGroup.GET("/home", shopHomeHandler)
    }
    r.Run(":8000")
}

func shopIndexHandler(c *gin.Context) {
    time.Sleep(5 * time.Second)
}

func shopHomeHandler(c *gin.Context) {
    time.Sleep(3 * time.Second)
}
//可以试试 打印结果