JavaWeb过滤器

过滤器(Filter)是JavaWEB的一个重要组件，又称为拦截器。基本功能是对Servlet容器调用Servlet的过程进行拦截，从而在Servlet进行响应处理的前后实现一些特殊的功能。Filter是一个实现了Filter接口的Java类，与Servlet程序相似，由Servlet容器进行调用和执行。Filter程序需要在web.xml中进行注册和设置它所能拦截的资源：Filter程序可以拦截JSP、Servlet、静态图片和静态HTML文件。

过滤器的实现

创建一个过滤器，通过实现Filter接口：

public class MyFilter implements Filter{   
}

Filter接口的方法：

• init()：在WEB应用程序启动时，WEB服务器将根据web.xml文件中的配置信息来创建每个注册的Filter对象。init()在创建Filter对象后被调用，且只被调用一次。用于对当前的Filter进行初始化操作。该方法传入一个FilterConfig参数，代表该Filter对象在web.xml中配置以及运行环境。
• doFilter()：每次拦截调用的方法。该方法传入三个参数：请求对象、响应对象以及过滤器链条。可以在代码中调用过滤器链的doFilter()方法将过滤器传入过滤器链的下一个。
• destroy()：在WEB容器卸载Filter对象之前被调用。该方法在Filter的生命周期中仅执行一次。通过这个方法，可以释放过滤器使用的资源。

public class MyFilter implements Filter {
    public void init(FilterConfig fConfig) throws ServletException {
        System.out.println("初始化过滤器...");
    }
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        System.out.println("过滤器进行拦截...")
        chain.doFilter(request, response);
    }
    public void destroy() {
        System.out.println("销毁过滤器...")
    }
}

配置过滤器

在当前WEB应用的web.xml文件中注册和配置：

<filter>
    <filter-name>MyFilterfilter-name>
    <filter-class>com.javaweb.MyFilterfilter-class>
filter>

<filter-mapping>
    <filter-name>MyFilterfilter-name>
    <url-pattern>/test.jspurl-pattern>
filter-mapping>

配置初始化参数

<filter>
    
    <init-param>
        <param-name>nameparam-name>
        <param-value>valueparam-value>
    init-param>
filter>

在配置映射时可以使用dispatcher节点来设置过滤器在何时工作，dispatcher节点可以设置多个

<filter-mapping>
    <dispatcher>REQUESTdispatcher>
    <filter-name>MyFilterfilter-name>
    <url-pattern>/test.jspurl-pattern>
filter-mapping>

dispatcher的值及其含义

dispathcer	含义
REQUEST	目标资源被用户直接访问时过滤器被调用
INCLUDE	目标资源通过RequestDispatcher的include()方法访问时过滤器被调用
FORWARD	目标资源通过RequestDispatcher的forward()方法访问时过滤器被调用
ERROR	目标资源通过声明式异常处理机制被调用时过滤器被调用

过滤器链

对于同一个拦截的对象，可能存在着多个过滤器，这些过滤器形成一个过滤器链。多个过滤器之间的拦截顺序与Filter在web.xml中映射有关。例如：

<filter-mapping>
    <filter-name>MyFilter2filter-name>
    <url-pattern>/test.jspurl-pattern>
filter-mapping>
<filter-mapping>
    <filter-name>MyFilterfilter-name>
    <url-pattern>/test.jspurl-pattern>
filter-mapping>

此时MyFilter2先进行拦截，之后MyFilter再进行拦截。

Created with Raphaël 2.1.2 request MyFilter2 MyFilter response

多个Filter之间通过chain.doFilter进行传递。

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
    /*
        过滤器处理代码...
    */

    chain.doFilter(request, response);  // 传递过滤器链
}chain.doFilter(request, response);