第二十七天

介绍一下gin中的中间件? (如何自定义一个中间件)

在 Gin 框架中，中间件（Middleware）是一种拦截 HTTP 请求处理流程的组件。中间件允许我们在请求到达实际处理函数之前或之后执行额外的逻辑，例如日志记录、身份验证、限流、响应数据封装等。

中间件的使用方式：

在 Gin 中，中间件是一个实现了 gin.HandlerFunc 接口的函数，该接口定义如下：

type HandlerFunc func(*Context)

HandlerFunc 接受一个 *gin.Context 参数，这是一个封装了 HTTP 请求和响应信息的对象，中间件可以通过操作这个上下文对象来影响请求的处理流程。

自定义中间件示例：

以下是如何在 Gin 中定义一个简单的自定义中间件的示例：

// 自定义中间件
func MyMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 请求进入中间件前的操作，比如记录请求开始时间
        start := time.Now()

        // 调用 Next() 会将控制权交给下一个中间件或路由处理函数
        c.Next()

        // 请求离开中间件后（即所有中间件和路由处理函数执行完毕）的操作，比如记录请求耗时
        latency := time.Since(start)
        log.Println("请求处理耗时: ", latency)
    }
}

// 注册并使用中间件
func main() {
    r := gin.Default()

    // 在全局级别注册中间件，所有路由都会经过此中间件
    r.Use(MyMiddleware())

    // 或者在特定路由组注册中间件
    api := r.Group("/api")
    api.Use(MyMiddleware())

    // 定义路由
    api.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{"message": "pong"})
    })

    r.Run(":8080")
}

在这个例子中，MyMiddleware 是一个简单的中间件，它在请求开始和结束时记录了请求的处理耗时。通过调用 c.Next()，中间件允许请求继续流向下一个中间件或最终的目标处理函数。

通过 r.Use() 方法，可以把中间件注册到全局或者特定的路由组中，从而对所有或部分请求生效。

gin的拦截器有c.next放行的方法, 那么它是如何做到执行完毕链路方法之后, 又返回到当前拦截器位置的呢?

在Gin框架中，中间件的执行过程是一个典型的“洋葱圈”模型或者说责任链模式。每个中间件函数在其内部调用c.Next()方法来执行下一个中间件或最终的处理函数。c.Next()方法实际上是将控制权传递给了下一个处理单元，并在那个处理单元执行完毕后返回到当前中间件。

具体流程如下：

1. 当请求到达时，首先由第一个中间件处理。
2. 在第一个中间件内部调用c.Next()，此时控制权转移到第二个中间件。
3. 第二个中间件再次调用c.Next()，控制权继续传递，直至到达最终的处理函数。
4. 最终处理函数执行完毕后，由于栈式的调用结构，控制权会逆序返回到调用它的中间件。
5. 当最后一个调用c.Next()的中间件恢复控制时，它会执行其在调用c.Next()之后的逻辑，即所谓的“后置处理”。
6. 这个过程会持续进行，直到最初的那个中间件执行完其“后置处理”逻辑。

这种设计使得每个中间件都能在请求的前后插入自己的处理逻辑，形成了一个嵌套执行又逐层返回的过程，类似于函数调用栈的压栈和弹栈操作。这就是Gin中间件通过c.Next()方法能做到执行完链路方法后又返回到当前拦截器位置的原因。