java Web 过滤器Filter详解

简介

Filter也称之为过滤器，Web开发人员通过Filter技术，对web服务器管理的所有web资源：例如Jsp, Servlet, 静态图片文件或静态 html 文件等进行拦截，从而实现一些特殊的功能。例如实现URL级别的权限访问控制、过滤敏感词汇、压缩响应信息等一些高级功能。

过滤器可以拦截请求和响应,，操作请求和响应中的数据,，控制是否允许访问目标资源,，url级别的拦截 (粗粒度)。

原理

一个过滤器

首先在HttpServletRequest到达 Servlet 之前，拦截客户的HttpServletRequest 。根据需要检查HttpServletRequest，也可以修改HttpServletRequest 头和数据。
然后在HttpServletResponse到达客户端之前，拦截HttpServletResponse 。根据需要检查HttpServletResponse，也可以修改HttpServletResponse头和数据。

基本应用

1，创建一个Filter

public class Filter1 implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 为了调用子类的方法
        HttpServletRequest httpServletRequest = (HttpServletRequest) request;
        System.out.println("***** 执行过滤器1 ... ...拦截路径: " + httpServletRequest.getRequestURI());
        // 允许访问目标资源,简称 放行
        chain.doFilter(httpServletRequest, response);
    }

    @Override
    public void destroy() {
    }

}

2，web.xml配置

<!-- 注册过滤器 -->
<filter>
    <filter-name>filter1</filter-name>
    <filter-class>com.test.web.filter.Filter1</filter-class>
    <!-- 配置当前过滤器的配置信息 -->
    <init-param>
        <param-name>safeNum</param-name>
        <param-value>10</param-value>
    </init-param>
</filter>
<!-- 映射过滤器需要拦截的路径 -->
<filter-mapping>
  <filter-name>filter1</filter-name>
  <url-pattern>/hello.jsp</url-pattern>
  <url-pattern>/HelloServlet</url-pattern>
</filter-mapping>

过滤器链（多个过滤器共同拦截）

注意：我们下面的两个过滤器都拦截了同样的路径，先后顺序是由映射决定的，而不是注册顺序，也就是说下面这两个过滤器先执行的是filter2而不是filter1

  <!-- 注册过滤器 -->
  <filter>
      <filter-name>filter1</filter-name>
      <filter-class>com.test.web.filter.Filter1</filter-class>
  </filter>
    <filter>
      <filter-name>filter2</filter-name>
      <filter-class>com.test.web.filter.Filter2</filter-class>
  </filter>
  <!-- 映射过滤器需要拦截的路径 -->
  <filter-mapping>
      <filter-name>filter2</filter-name>
      <url-pattern>/hello.jsp</url-pattern>
      <url-pattern>/HelloServlet</url-pattern>
  </filter-mapping>
  <filter-mapping>
      <filter-name>filter1</filter-name>
      <url-pattern>/hello.jsp</url-pattern>
      <url-pattern>/HelloServlet</url-pattern>
  </filter-mapping>

生命周期

如下所示，1：实例化 2，初始化 3，拦截工作 4，销毁

public class Filter2 implements Filter {

    public Filter2() {
        System.out.println("----------- 1 执行Filter2的构造方法");
    }

    public void init(FilterConfig fConfig) throws ServletException {
        System.out.println("----------- 2 执行Filter2的初始化方法");
    }

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 为了调用子类的方法
        HttpServletRequest httpServletRequest = (HttpServletRequest) request;
        System.out.println("----------- 3 执行Filter2的执行拦截的方法 , 拦截路径:" + httpServletRequest.getRequestURI());// 放行
        chain.doFilter(request, response);
    }

    public void destroy() {
        System.out.println("----------- 4 执行Filter2的销毁的方法 ");
    }

}

过滤器拦截方式

1 直接请求(默认)

2 请求转发(forward)

3 错误页面跳转(error)

4 引入其他页面(include)

如果你修改拦截方式，需要在web.xml中通过 dispatcher标签指定。

    <filter>
        <display-name>Filter2</display-name>
        <filter-name>Filter2</filter-name>
        <filter-class>com.test.web.filter.Filter2</filter-class>
        <!-- 配置当前过滤器的配置信息 -->
        <init-param>
            <param-name>safeNum</param-name>
            <param-value>10</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>Filter2</filter-name>
        <url-pattern>/hello.jsp</url-pattern>
        <!-- 配置拦截jsp的方式: 请求转发 -->
        <dispatcher>FORWARD</dispatcher>
        <!-- 增加拦截方式: 直接请求 -->
        <dispatcher>REQUEST</dispatcher>
    </filter-mapping>
    <filter-mapping>
        <filter-name>Filter2</filter-name>
        <url-pattern>/HelloServlet</url-pattern>
    </filter-mapping>

案例演示一：解决post方式获取参数乱码和浏览器乱码

Filter：

public class EncodingFilter implements Filter {

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 1 解决获取参数中文乱码(post)
        request.setCharacterEncoding("utf-8");
        // 2 解决浏览器出现的中文乱码
        response.setContentType("text/html;charset=utf-8");
        chain.doFilter(request, response);
    }

    public void destroy() {
    }

    public void init(FilterConfig fConfig) throws ServletException {
    }

}

web.xml：

  <filter>
    <display-name>EncodingFilter</display-name>
    <filter-name>EncodingFilter</filter-name>
    <filter-class>com.test.web.filter.EncodingFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>EncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

案例演示二：统一解决get和post获取参数乱码