Servlet中的过滤器Filter

过滤器（Filter）

1. 作用及用法：Servlet 过滤器可以动态地拦截请求和响应，以变换或使用包含在请求或响应中的信息。可以将一个或多个 Servlet 过滤器附加到一个 Servlet 或一组 Servlet。Servlet 过滤器也可以附加到 JavaServer Pages (JSP) 文件和 HTML 页面。调用 Servlet 前调用所有附加的 Servlet 过滤器。
2. 实现的功能（可用于Servlet编程的Java类）：
   a.在客户端的请求访问后端资源之前，拦截这些请求。
   b. 在服务器的响应发送回客户端之前，处理这些响应。
3. 过滤器的类型

 a.身份验证过滤器（Authentication Filters）。
 b.数据压缩过滤器（Data compression Filters）。
 c.加密过滤器（Encryption Filters）。
 d.触发资源访问事件过滤器。
 e.图像转换过滤器（Image Conversion Filters）。
 f.日志记录和审核过滤器（Logging and Auditing Filters）。
 g.MIME-TYPE 链过滤器（MIME-TYPE Chain Filters）。
 h.标记化过滤器（Tokenizing Filters）。
 i.XSL/T 过滤器（XSL/T Filters），转换 XML 内容。

4. 主要方法：

public void doFilter (ServletRequest, ServletResponse, FilterChain)；
//过滤操作，当客户端请求方法与过滤器设置匹配的URL时，Servlet容器将先调用过滤器的doFilter方法。FilterChain用户访问后续过滤器。
public void init(FilterConfig filterConfig)；
//web 应用程序启动时，web 服务器将创建Filter 的实例对象，并调用其init方法，读取web.xml配置，完成对象的初始化功能，从而为后续的用户请求作好拦截的准备工作（filter对象只会创建一次，init方法也只会执行一次）。开发人员通过init方法的参数，可获得代表当前filter配置信息的FilterConfig对象。
public void destroy()
//Servlet容器在销毁过滤器实例前调用该方法，在该方法中释放Servlet过滤器占用的资源。

5. 过滤器的应用场景：
   ①.执行目标资源之前做"预处理"工作，例如设置编码，这种通常都会放行，只是在目标资源执行之前做一些准备工作。(例如：几乎是所有的Servlet中都需要写request.setCharacteEncoding(),可以把它放入到一个Filter中。）这种过滤器没有拦截功能。
   ②.通过条件判断是否放行，例如校验当前用户是否已经登录，或者用户IP是否已经被禁用。(有拦截操作) (粗粒度权限控制，会员有会员的权利、游客有游客的权利)。
   ③.在目标资源执行后，做一些后续的特殊处理工作。例如把目标资源输出的数据进行处理。
   6.代码示例：

//导入必需的 java 库
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;

@WebFilter("/*")
//实现 Filter 类
public class CharsetFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    
        //输出初始化参数
        System.out.println("CharsetFilter.init");
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        // 输出站点名称
        System.out.println("CharsetFilter.doFilter");
        
        //解决字符乱码问题
        servletRequest.setCharacterEncoding("utf-8");
        servletResponse.setCharacterEncoding("utf-8");

        // 把请求传回过滤链
        filterChain.doFilter(servletRequest,servletResponse);
    }

    @Override
    public void destroy() {
        /* 在 Filter 实例被 Web 容器从服务移除之前调用 */
        System.out.println("CharsetFilter.destroy");
    }
}

7.多个过滤器的执行顺序：
Web应用程序可以根据特定的目的定义若干个不同的过滤器，那么就需要在web.xml中对多个过滤器进行多个配置。而在web.xml中使用来控制多个过滤器的执行顺序，即哪个过滤器的配置在web.xml中的顺序排在前面那这个过滤器就先执行。
代码示例：

web.xml中
<filter>
   <filter-name>Frist</filter-name>
   <filter-class>com.test.Frist</filter-class>
   <init-param>
      <param-name>test-param</param-name>
      <param-value>Initialization Paramter</param-value>
   </init-param>
</filter>

<filter>
   <filter-name>Second</filter-name>
   <filter-class>com.test.Second</filter-class>
   <init-param>
      <param-name>test-param</param-name>
      <param-value>Initialization Paramter</param-value>
   </init-param>
</filter>

<filter-mapping>
   <filter-name>Frist</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

<filter-mapping>
   <filter-name>Second</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

/*先执行First,然后再执行Second*/