Nutz-过滤器

什么是过滤器?

一个 HTTP 请求，过滤器是第一组被执行的对象。同适配器不同的是，一个请求中，可以执行多个过滤器。

---

如何使用过滤器？

通过 @Filters 注解。

注解 '@Filters' 的值是一个 '@By' 注解的数组，它可以声明在这三个地方

1. 入口函数
2. 子模块
3. 主模块

 其中入口函数的 @Filters 优先级更高，其次是子模块，最后是主模块。

就是说，你在入口模块声明了两个过滤器：

@Filters({@By(type=Filter1.class), @By(type=Filter2.class)})
public final class MainModule{
    ...

在某一个入口函数上声明了一个空的过滤器数组：

...
@At
@Filters
public String myFunction(){
    ...

那么，这个入口函数将不会应用任何过滤器。

---

使用内置过滤器

@Filters(@By(type=CheckSession.class, args={"user", "/login.jsp"}))

CheckSession 是 Nutz.Mvc 为你内置的一个唯一的过滤器，它的构造函数需要两个参数：

• 检查 session 的什么属性？
• 如果不存在，重定向到哪里？

---

定制你自己的过滤器

定制你自己的过滤器，请注意过滤器接口代码：

public interface ActionFilter {
    View match(ActionContext context);
}

根据 HttpRequest 对象，过滤器需要决定返回值是：

• 一个 View : 这个请求有问题，不要继续执行了，马上用这个 View 来渲染 HTTP 输出流吧
• null : 恩，这个请求没问题，继续吧。

如果过滤器返回的是 null，Nutz.Mvc 会继续执行下一个过滤器，如果全部的过滤器都返回 null 它就会调用适配器，进行后面的操作。

取至：http://www.nutzam.com/core/mvc/action_filter.html