Servlet过滤器笔记

开发十年，就只剩下这套Java开发体系了 >>>   

• Servlet过滤器用来动态拦截浏览器请求和服务端相应，对包含在请求或响应中的信息进行统一处理。
• 一个过滤器可以附加在一个或多个Servlet上，也可以附加在JSP和HTML页面中。调用Servlet前调用所有的Servlet过滤器。

实现Servlet过滤器：

实现Servlet过滤器关键有两点，实现Filter接口，在web.xml中配置过滤器。

要实现Filter接口，首先了解Filter接口声明了哪些方法：

• public void init(FilterConfig filterConfig)：初始化过滤器（filter对象只会创建一次，init方法也只会执行一次）。
• public void doFilter (ServletRequest, ServletResponse, FilterChain)：该方法完成实际的过滤操作。
• public void destroy()：Servlet容器在销毁过滤器实例前调用该方法，在该方法中释放Servlet过滤器占用的资源。

init()方法：

web 应用程序启动时，web 服务器将创建Filter 的实例对象，并调用其init方法，读取web.xml配置，完成对象的初始化功能，从而为后续的用户请求作好拦截的准备工作。

init()方法中提供了一个FilterConfig对象，这是一个配置对象，在web.xml中可以进行如下配置：

<filter>
    <filter-name>FilterTest</filter-name>
    <filter-class>com.hellotomcat.test.FilterTest</filter-class>
    <init-param>
        <param-name>name</param-name>
        <param-value>value</param-value>
    </init-param>
</filter>

一般情况下只需要配置<filter-name>和<filter-class>即可，配置的参数可以在init()方法中获取：

public void  init(FilterConfig config) throws ServletException {
    // 获取初始化参数
    String value = config.getInitParameter("name"); 
    // 输出初始化参数
    System.out.println("name: " + value); 
}

doFilter()方法：

该方法完成实际的过滤操作，当客户端请求方法与过滤器设置匹配的URL时，Servlet容器将先调用过滤器的doFilter方法。该方法参数列表中最后一个参数FilterChain是过滤链，用于返回响应。

一个示例：

public void  doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws java.io.IOException, ServletException {
    // 控制台输出访问信息
    System.out.println("正在访问***站点");
    // 把请求传回过滤链
    chain.doFilter(request,response);
}

destroy()方法：

用于在过滤器被回收时释放资源。

配置过滤器：

<filter>
    <filter-name>FilterTest</filter-name>
    <filter-class>com.hellotomcat.test.FilterTest</filter-class>
    <init-param>
        <param-name>name</param-name>
        <param-value>value</param-value>
    </init-param>
</filter>

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

如果需要配置多个过滤器，只需要在配置文件中依次配置每个过滤器即可。web.xml 中的 filter-mapping 元素的顺序决定了 Web 容器应用过滤器到 Servlet 的顺序。