转载

Filter ：过滤请求和响应

filter对象可以改变请求和响应的头信息和内容信息。过滤器和web组件的不同之处在于，过滤器通常不会自行创建响应。作为替代，过滤器提供附加到任意类型的web资源的功能。因此，过滤器不该对要过滤的web资源有任何依赖。这样，它可以由多种web资源组成。

过滤器可以执行的主要任务如下：

查询请求并采取响应措施
组织请求-响应对的进一步传递
修改请求头和数据。你可以通过设置请求的自定义版本来完成此操作。
修改响应头和数据。你可以通过设置响应的自定义版本来完成此操作。
与web资源相互作用

应用程序的过滤器包含认证、日志、图片转换、数据压缩、数据加密、标记流、xml转换等。

你可以给一个web资源配置0-多个过滤器，并且可以自定义过滤器的顺序。过滤器链在包含此组件的web资源部署时指定，并且在web容器加载的时候实例化。

编写filter程序

filtering api定义在javax.servlet包中的Filter, FilterChain, and FilterConfig接口中。你可以通过实现Filter接口定义一个过滤器。

使用@WebFilter注解在web程序中定义过滤器。这个注解作用在类上，并且包含过滤器的元数据。过滤器注解必须定义至少一个url匹配，通过使用z注解的urlPatterns或value属性完成这个操作。所有其他的属性都是可选的，有默认设置。当只有一个url规则时使用value注解；当有多个url规则或需要自定义属性时使用urlPatterns注解。

使用@WebFilter 注解的类必须实现 javax.servlet.Filter 接口。

要将配置数据添加到过滤器中，可以使用@WebFilter注解的initParams属性。initParams属性包含一个 @WebInitParam 注解。下面的代码片段定义了一个过滤器，定义了一个初始化参数：

import javax.servlet.Filter;
import javax.servlet.annotation.WebFilter;
import javax.servlet.annotation.WebInitParam;

@WebFilter(filterName = "TimeOfDayFilter",
urlPatterns = {"/*"},
initParams = {
    @WebInitParam(name = "mood", value = "awake")})
public class TimeOfDayFilter implements Filter {
    ...

Filter接口的最重要的方法是doFilter，这个方法可以执行下列操作：

核查请求头
定制请求对象，如果过滤器想要修改请求头或数据
定制响应对象，如果过滤器想要修改响应头或数据
调用过滤器链的下一个实体。如果当前过滤器是过滤器链的最后一个过滤器，并且结束目标是web资源或静态资源，下一个实体是链末端的资源；否则，下一个实体是war定义的过滤器。过滤器通过调用chain对象的doFilter方法调用下一个实体，传入调用它的请求、响应或它创建的包装版本。换种说法是，filter可以通过不调用下一个实体来阻塞请求。在后一种情况下，过滤器负责填充响应。
在调用下一个实体后核查响应头
抛出一个错误指示执行流程中的错误

执行doFilter，你必须实现init和destroy方法。init方法在web容器实例化的时候调用；如果你想给filter传入初始化参数，可以通过传入init方法的FilterConfig参数获取它们。

编写自定义请求和响应代码

过滤器有多种方式去修改请求和响应。例如，一个过滤器可以向请求添加一个参数或者在响应中插入数据。

过滤器修改响应必须在响应返回客户端之前捕获响应。为此，您将一个替代流传递给生成响应的servlet。备用流阻止servlet在完成时关闭原始响应流，并允许过滤器修改servlet的响应。

要将此替换流传递给servlet，过滤器会创建一个响应包装器，它会覆盖getWriter或getOutputStream方法以返回此替换流。这个包装器通过过滤器链doFilter方法传递。包装器方法默认调用包装的请求或响应对象。

重写请求方法，你包装的请求必须继承ServletRequestWrapper或HttpServletRequestWrapper。重写响应方法，你的响应必须继承ServletResponseWrapper or HttpServletResponseWrapper。

指定过滤器映射

web容器使用请求映射决定给web资源应用具体的过滤器。过滤器映射使用名称映射一个过滤器到web组件或者使用url规则匹配到web资源。过滤器按照war中定义的顺序执行。您可以使用NetBeans IDE或使用XML手动编写列表来为其部署描述符中的WAR指定过滤器映射列表。

如果你想记录每一个到web应用的请求，你可以将过滤器映射到url规则“/”。

可以映射filter到一个或多个web资源，当然你也可以给一个web资源映射多个filter。参见下图，F1映射到S1、S2、S3,F2映射到S2,F3映射到S1、S2.

Filter ：过滤请求和响应

再次强调，filter chain是传入filter的doFilter方法的一个参数。该链通过过滤器映射间接生成。链中的过滤器顺序与过滤器映射在Web应用程序部署描述符中的显示顺序相同。当一个过滤器映射到S1,web容器调用F1的doFilter方法。S1的过滤器链中每个过滤器的doFilter方法由链中的前一个过滤器通过chain.doFilter方法调用。因为S1的过滤器链包含过滤器F1和F3，所以F1对chain.doFilter的调用会调用过滤器F3的doFilter方法。当F3的doFilter方法完成时，控制返回F1的doFilter方法。