首页 > 代码库 > Java Web开发——Filter过滤器

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开发——Filter过滤器