gin框架 中间件 Abort()

gin 框架中间件处理有两个重要的函数 Next() 和 Abort()。

Abort 函数在被调用的函数中阻止后续中间件的执行。例如,你有一个验证当前的请求是否是认证过的 Authorization 中间件。如果验证失败(例如,密码不匹配),调用 Abort 以确保这个请求的其他函数不会被调用。

有个细节需要注意,调用 Abort 函数不会停止当前的函数的执行,除非后面跟着 return。

1. gin 中间件 Abort() 的定义

gin 中间件 Abort() 使用方法如下:

func (c *Context)Abort()

比如:

func MiddleWare() gin.HandlerFunc {
    return func(c *gin.Context) {
        c.Abort()
    }
}

2. gin 中间件 Abort() 的范例

我们的案例中共有三个中间件,其中在中间件1中,调用了 Abort 函数。

package main

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

// 定义中间件1
func MiddleWare1() gin.HandlerFunc {
    return func(c *gin.Context) {
        fmt.Println("调用中间件1")

        // 调用 Abort,终止执行后续的中间件
        c.Abort()
    }
}

// 定义中间件2
func MiddleWare2() gin.HandlerFunc {
    return func(c *gin.Context) {
        fmt.Println("调用中间件2")
    }
}

// 定义中间件3
func MiddleWare3() gin.HandlerFunc {
    return func(c *gin.Context) {
        fmt.Println("调用中间件3")
    }
}

func main() {
    // 创建路由
    engine := gin.Default()

    // 注册中间件
    engine.Use(MiddleWare1(), MiddleWare2(), MiddleWare3())

    // 路由规则
    engine.GET("/", func(c *gin.Context) {
        fmt.Println("调用路由处理函数")
        // 页面接收
        c.JSON(200, gin.H{"request": "编程教程 gin框架"})
    })

    engine.Run()
}

运行程序,并在浏览器输入:http://localhost:8080,控制台日志会输出:

[GIN-debug] GET    /   --> main.main.func1 (4 handlers)
[GIN-debug] Listening and serving HTTP on :8080
调用中间件1
[GIN] 2021/05/31 - 12:03:13 | 200 |  193.22µs | ::1 | GET "/"

说明只有中间件1被调用,其余的中间件被取消执行,而且页面处理函数也被取消执行。

下一章:gin框架 中间件 Next

gin框架 中间件 Next():gin 框架中间件处理有两个重要的函数 Next() 和 Abort()。Next 函数会挂起当前所在的函数,然后调用后面的中间件,待后面中间件执行完毕后,再接着执行当前函数。gin 中间件 Next() 使用方法如下:func (c *Context)Next()。