听说你叫Java（三）–Servlet过滤器

听说你改bug很厉害，帮我改一个吧
????

上一章我们讲到了Servlet请求，可以通过浏览器发送的请求，来进行数据的处理并返回相应的响应给浏览器。

在我们的实际开发中，常常会遇到一些对所有方法都需要的验证方法，比如登录验证等，这个时候我们在每个方法中都编写同样的功能代码，既浪费时间也不利于维护。

幸好，Servlet给我们提供了过滤器解决这个问题。

是什么

Servlet 过滤器可以动态地拦截请求和响应，以变换或使用包含在请求或响应中的信息。

可以将一个或多个 Servlet 过滤器附加到一个 Servlet 或一组 Servlet。调用 Servlet 前调用所有附加的 Servlet 过滤器。

Servlet 过滤器可以实现以下目的：

• 在客户端的请求访问后端资源之前，拦截这些请求。

• 在服务器的响应发送回客户端之前，处理这些响应。

同样的，Servlet过滤器是可用于 Servlet 编程的 Java 类，也需要在XML中声明的。Filter执行顺序和在web.xml中声明的顺序一致，通常把Filter配置在所有逻辑Servlet之前。

如何用

Servlet通过javax.servlet.Filter接口来实现过滤器，接口提供了三个方法：

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过滤器占用的资源。

配置过滤器web.xml节点说明

节点	说明
<filter>	指定这个过滤器
<filter-name>	过滤器的名称
<filter-class>	过滤器完整类名
<init-param>	元素用于为过滤器指定初始化参数，它的子元素<param-name>指定参数的名字，<param-value>指定参数的值。
<filter-mapping>	元素用于设置一个 Filter 所负责拦截的资源。一个Filter拦截的资源可通过两种方式来指定：Servlet 名称和资源访问的请求路径
<filter-name>	子元素用于设置filter的注册名称。该值必须是在<filter>元素中声明过的过滤器的名字
<url-pattern>	设置 filter 所拦截的请求路径(过滤器关联的URL样式)

举个例子

我们接着上一章的小栗子继续扩展我们的应用。

1. 新建一个class类，这里需要注意的是，如果我们要在过滤器中返回值给浏览器，需要引入相应的库才行。

package com.filter;

//导入必要的依赖库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;

//实现Filter类
public class FirstFilter implements Filter {
    public void init(FilterConfig config) throws ServletException {
        //获取web.xml中初始化的参数
        String name = config.getInitParameter("name");
        //输出
        System.out.println("请关注："+ name);
    }
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)  throws java.io.IOException, ServletException {
        System.out.println("我在doFilter中");
        
        String message = "我跨越过滤器来跟你说";
        // 设置响应内容类型
        response.setContentType("text/html;charset=utf-8");
        // 实际的逻辑是在这里
        PrintWriter out = response.getWriter();
        out.println("<h1>" + message + "</h1>");
        //把请求传回过滤链
        chain.doFilter(request, response);
    }
    public void destroy(){
        //do something
    }
}

2. web.xml中同样配置好，将过滤器添加到servlet的上方

<web-app>
  <filter>
      <filter-name>FirstFilter</filter-name>
      <filter-class>com.filter.FirstFilter</filter-class>
      <init-param>
        <param-name>name</param-name>
        <param-value>野生前端攻城狮</param-value>
      </init-param>
  </filter>
  <filter-mapping>
      <filter-name>FirstFilter</filter-name>
      <url-pattern>/*</url-pattern>
  </filter-mapping>
  <servlet>
      <servlet-name>HelloWorld</servlet-name>
      <servlet-class>com.servletLearn.HelloWorld</servlet-class>
  </servlet>

  <servlet-mapping>
      <servlet-name>HelloWorld</servlet-name>
      <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

3. 看结果

可以看到，我们在项目启动的时候，执行了Filter的init()方法，所以在服务器日志中看到了打印请关注野生前端攻城狮字符串。

使用浏览器打开对应的链接时，同样在服务器日志中也出现了我们打印的字符串。而在浏览器中，则同时出现了我们在过滤器和HelloWorld方法中返回的字符串。

所以，我们在过滤器中返回的值，并没有影响原来Servlet方法的执行。

最后

过滤器在日常开发中适用范围非常广泛，所以是我们学习servlet所必须要掌握的一个知识点。

PS：过滤器和拦截器是两个完全不同的概念。过滤器是原生servlet的类，拦截器是Spring及struts2里的概念