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获取参数乱码