过滤器

最后更新于:2022-04-01 04:22:07

过滤器是Revel框架的中间件 – 是组成请求处理管道的独立的功能。他们执行框架的所有功能。 过滤器类型是一个简单的函数: ~~~ type Filter func(c *Controller, filterChain []Filter) ~~~ 每个过滤器负责调用过滤器链中的下一个过滤器。下面是个默认的过滤器栈: ~~~ // Filters 是默认的全局过滤器集。 // 可以在程序初始化时设置它。 var Filters = []Filter{ PanicFilter, // 从恐慌中恢复,并显示一个错误页面。 RouterFilter, // 负责解析路由,并选择正确的控制器方法。 FilterConfiguringFilter, // 用于添加/删除每个动作过滤的钩子。 ParamsFilter, // 解析参数到 Controller.Params 中。 SessionFilter, // 恢复和写入会话 cookie。 FlashFilter, // 恢复和写入 flash cookie。 ValidationFilter, // 恢复保存验证错误并保存新的Cookie中。 I18nFilter, // 解析请求语言。 InterceptorFilter, // 执行拦截器。 ActionInvoker, // 调用控制器。 } ~~~ ## 过滤器链配置 ### 全局配置 程序可以在 `init()` 中重写 `revel.Filters` 变量,来配置过滤器链 (默认在 `app/init.go`)。 ~~~ func init() { // Filters 是默认的全局过滤器集。 revel.Filters = []Filter{ PanicFilter, // 从恐慌中恢复,并显示一个错误页面。 RouterFilter, // 负责解析路由,并选择正确的控制器方法。 FilterConfiguringFilter, // 用于添加/删除每个动作过滤的钩子。 ParamsFilter, // 解析参数到 Controller.Params 中。 SessionFilter, // 恢复和写入会话 cookie。 FlashFilter, // 恢复和写入 flash cookie。 ValidationFilter, // 恢复保存验证错误并保存新的Cookie中。 I18nFilter, // 解析请求语言。 InterceptorFilter, // 执行拦截器。 ActionInvoker, // 调用控制器。 } } ~~~ 每个请求沿着过滤器链从上到下依次执行。 ### Per-Action configuration 尽管所有的请求都被发往过滤器链 `revel.Filters`, Revel 也提供了 [`过滤器配置`](http://gorevel.cn/docs/docs/godoc/filterconfig.html#FilterConfigurator), 允许开发者根据操作或控制器添加、插入、删除过滤器。 此功能通过 `FilterConfiguringFilter` 实现, 它本身就是一个过滤器. ## 实现一个过滤器 ### 保持过滤器链能够依次执行 Filters 负责依次调用下一个过滤器来依次处理请求。这通常需要完成下面的表达式: ~~~ var MyFilter = func(c *revel.Controller, fc []revel.Filter) { // .. 做一些预处理 .. fc[0](c, fc[1:]) // 执行下一个过滤器 // .. 做一些后期处理 .. } ~~~ ### 获取控制器类型 Filters 接受一个 `*Controller` 类型的参数, 而不是被调用的实际的控制器类型。如果过滤器需要访问实际的控制器类型,可以这样实现: ~~~ var MyFilter = func(c *revel.Controller, fc []revel.Filter) { if ac, err := c.AppController.(*MyController); err == nil { // 判定存在一个 *MyController 实例... } fc[0](c, fc[1:]) // 执行下一个过滤器 } ~~~ 注意:这种模式往往说明[拦截器](http://gorevel.cn/docs/manual/interceptors.html)可能是实现所需功能的好的机制的一个指标。
';