Skip to main content
Version: 2.1.x

GoFrame 提供了优雅的中间件请求控制方式，该方式也是主流的 WebServer 提供的请求流程控制方式，基于中间件设计可以为 WebServer 提供更灵活强大的插件机制。经典的中间件洋葱模型：

中间件定义​

中间件的定义和普通HTTP执行方法 HandlerFunc 一样，但是可以在 Request 参数中使用 Middleware 属性对象来控制请求流程。

我们拿一个跨域请求的中间件定义来示例说明一下：

func MiddlewareCORS(r *ghttp.Request) {
    r.Response.CORSDefault()
    r.Middleware.Next()
}

可以看到在该中间件中执行完成跨域请求处理的逻辑后，使用 r.Middleware.Next() 方法进一步执行下一个流程；如果这个时候直接退出不调用 r.Middleware.Next() 方法的话，将会退出后续的执行流程（例如可以用于请求的鉴权处理）。

中间件类型​

中间件的类型分为两种：前置中间件和后置中间件。前置即在路由服务函数调用之前调用，后置即在其后调用。

前置中间件​

其定义类似于：

func Middleware(r *ghttp.Request) {
    // 中间件处理逻辑
    r.Middleware.Next()
}

后置中间件​

其定义类似于：

func Middleware(r *ghttp.Request) {
    r.Middleware.Next()
    // 中间件处理逻辑
}

中间件注册​

中间件的注册有多种方式，参考接口文档： https://pkg.go.dev/github.com/gogf/gf/v2/net/ghttp

全局中间件​

func (s *Server) Use(handlers ...HandlerFunc)

全局中间件是可以 独立使用 的请求拦截方法，通过路由规则的方式进行注册，绑定到 Server 上，由于中间件需要执行请求拦截操作，因此往往是使用"模糊匹配"或者"命名匹配"规则。

全局中间件仅对动态请求拦截有效，无法拦截静态文件请求。

分组路由中间件​

func (g *RouterGroup) Middleware(handlers ...HandlerFunc) *RouterGroup

分组路由中注册的中间件绑定到当前分组路由中的所有的服务请求上，当服务请求被执行前会调用到其绑定的中间件方法。 分组路由仅有一个 Middleware 的中间件注册方法。分组路由中间件与全局中间件不同之处在于， 分组路由中间件无法独立使用，必须在分组路由注册中使用，并且绑定到当前分组路由中所有的路由上作为路由方法的一部分。

执行优先级​

全局中间件​

由于全局中间件也是通过路由规则执行，那么也会存在执行优先级：

  1. 首先，由于全局中间件是基于模糊路由匹配，因此 当同一个路由匹配到多个中间件时，会按照路由的深度优先规则执行，具体请查看路由章节；
  2. 其次， 同一个路由规则下，会按照中间件的注册先后顺序执行，中间件的注册方法也支持同时按照先后顺序注册多个中间件；
  3. 最后，为避免优先级混淆和后续管理，建议将所有中间件放到同一个地方进行先后顺序注册来控制执行优先级；

这里的建议来参考于 gRPC 的拦截器设计，没有过多的路由控制，仅在一个地方同一个方法统一注册。往往越简单，越容易理解，也便于长期维护。

分组路由中间件​

分组路由中间件是绑定到分组路由上的服务方法，不存在路由规则匹配，因此只会按照注册的先后顺序执行。参考后续示例。