Java Web开发——Filter过滤器

一、过滤器

1.1定义

过滤器是一个服务器端的组件，它可以截取用户端的请求与响应信息，并对这些信息进行过滤。

1.2工作原理

1、项目启动时，从Web容器中加载过滤器；

2、过滤器存在于用户请求和Web资源之间；

3、用户请求和Web响应之间的收发都经由过滤器按照过滤规则进行过滤筛选。

1.3过滤器的生命周期

实例化(web.xml加载)→初始化（init方法）→过滤(doFilter方法)→销毁(destroy方法)

1、初始化：当容器第一次加载该过滤器时，init() 方法将被调用。该类在这个方法中包含了一个指向 Filter Config 对象的引用。我们的过滤器实际上并不需要这样做，因为其中没有使用初始化信息，这里只是出于演示的目的。

2、过滤：过滤器的大多数时间都消耗在这里。doFilter方法被容器调用，同时传入分别指向这个请求/响应链中的 Servlet Request、Servlet Response 和 Filter Chain 对象的引用。然后过滤器就有机会处理请求，将处理任务传递给链中的下一个资源(通过调用 Filter Chain 对象引用上的 doFilter方法)，之后在处理控制权返回该过滤器时处理响应。

3、销毁：容器紧跟在垃圾收集之前调用 destroy()方法，以便能够执行任何必需的清理代码。

过滤器链：服务器会按照web.xml中过滤器定义的先后顺序组装成一条链

1.4过滤器在web.xml中的基本配置

过滤器在web.xml中的的配置：

<filter>
    <filter-name>过滤器名称</filter-name>
    <filter-class>过滤器完整类名</filter-class>
    <init-param>
        <description>描述信息，可以省略</description>
        <param-name>参数名称</param-name>
        <param-value>参数值</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>过滤器名称</filter-name>
    <url-pattern>URL</url-pattern>
    <dispatcher>[REQUEST|INCLUDE|FORWARD|ERROR]</dispatcher>
</filter-mapping>

1.5过滤器的分类

过滤器的分类表

类型	作用
REQUEST	用户直接访问页面时，web容器会调用该过滤器
FORWARD	目标资源是通过RequestDispatcher的forward方法访问时，过滤器将被调用
INCLUDE	目标资源是通过RequestDispatcher的include方法调用时，过滤器将被调用
ERROR	目标资源是通过声明式异常处理机制调用时，过滤器被将被调用
ASYNC(Servlet3.0新增加)	支持异步处理

二、过滤器的基本使用

2.1 过滤器类的设计

实现Filter接口，重写init、doFilter、destroy方法

public class MyFilter implements Filter{
    public void init(FilterConfig filterConfig) throws ServletException{}
    /**
    *使浏览器不缓存页面的过滤器
    */
    public void doFilter(ServlerRequest request,ServletResponse response,FilterChain filterChian) throws IOException,ServletException{
      ((HttpServletResponse) response).setHeader("Cache-Control","no-cache");
      ((HttpServletResponse) response).setHeader("Pragma","no-cache");
      ((HttpServletResponse) response).setDateHeader ("Expires", -1);
      filterChain.doFilter(request, response);//将处理任务传递给过滤器链中的下一个资源
    }
    public void destroy(){}
}

2.2 过滤器在web.xml中的注册

1、REQUEST、FORWARD、INCLUDE等类型过滤器的注册

<!-- 过滤器配置 -->
<filter>
    <filter-name>myFilter</filter-name>
    <filter-class>util.filter.MyFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>myFilter</filter-name>
    <url-pattern>/main.jsp</url-pattern>
    <dispatcher>[REQUEST|FORWARD|INCLUDE]</dispatcher>
</filter-mapping>

2、ERROR类型的过滤器注册

<!-- 配置错误页面，当出现404错误则跳转至/error.jsp页面 -->
<error-page>
    <error-code>404</error-code>
    <location>/error.jsp</location>
<error-page>
<!-- 过滤器配置 -->
<filter>
    <filter-name>errorFilter</filter-name>
    <filter-class>util.filter.ErrorFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>errorFilter</filter-name>
    <url-pattern>/error.jsp</url-pattern>
    <dispatcher>ERROR</dispatcher>
</filter-mapping>

三、Servlet3.0中过滤器的使用

加上 @WebFilter 注解即可，无需在web.xml中注册

@WebFilter(servletNames={"SimpleServlet"},filterName="SimpleFilter")
public class MyFirstFilter implements Filter{}

@WebFilter常用属性表

属性名	类型	描述
filterName	String	指定过滤器的name属性，等价于<filter-name>
value	String[]	等价于urlPatterns属性，但是两者不要同时使用，若同时使用，优先使用value属性
urlPatterns	String[]	指定一组过滤器的URL匹配模式，等价于<utl-pattern>标签
servletNames	String[]	指定过滤器将应用于哪些Servlet。取值是@WebServlet中的name属性值，或者是web.xml中的<servlet-name>取值
dispatcherTypes	DispatcherType	指定过滤器的转发模式。具体取值包括ASYNC、ERROR、FORWARD、INCLUDE、REQUEST
initParams	WebInitParam[]	指定一组过滤器初始化参数，等价于<init-param>标签
asyncSupported	boolean	声明过滤器是否支持异步操作模式，等价于<async-supported>标签
description	String	该过滤器的描述信息，等价于<description>标签
displayName	String	该过滤器的显示名，等价于<display-name>标签

参考资料：慕课网【JAVA Web开发技术应用——过滤器】http://www.imooc.com/learn/213