【Springboot】Filter 过滤器的使用

╰半夏微凉° 2024-03-01 08:25 67阅读 0赞

## 一、基本介绍 ##

过滤器 Filter 作为 Java 三大器之一，在 Java Web 的使用中有很高的地位。所谓过滤器，就是实现了 javax.servlet.Filter 接口的服务器端程序，就是对事物进行过滤的。在 Web 中的过滤器，当然就是对请求进行过滤，我们使用过滤器，就可以对请求进行拦截，然后做相应的处理，实现许多特殊功能。如登录控制，权限管理，过滤敏感词汇等。

使用Filter完整的流程是：Filter对用户请求进行预处理，接着将请求交给Servlet进行预处理并生成响应，最后Filter再对服务器响应进行后处理。

## 二、过滤器原理 ##

当我们使用过滤器时，过滤器会对游览器的请求进行过滤，过滤器可以动态的分为 3 个部分，**1. 放行之前的代码，2. 放行，3. 放行后的代码**，这 3 个部分分别会发挥不同作用。

*  第一部分代码会对游览器请求进行第一次过滤，在 HttpServletRequest 到达 Servlet 之前，拦截客户的 HttpServletRequest。
 *  第二部分根据需要检查 HttpServletRequest，也可以修改 HttpServletRequest 头和数据，如果还有过滤器，那么就继续交给下一个过滤器。
 *  第三部分在 HttpServletRequest 到达客户端之前，拦截 HttpServletResponse，对返回的 Web 资源再次进行过滤处理。

我们使用过滤器，也就是说，不止请求会经过过滤器，我们的响应也会经过过滤器。

![6a561fd966b04cf58193f70d6aa66eb0.png][]

## 三、过滤器的作用 ##

* Examples that have been identified for this design are
     * 1) Authentication Filters, 即用户访问权限过滤
     * 2) Logging and Auditing Filters, 日志过滤，可以记录特殊用户的特殊请求的记录等
     * 3) Image conversion Filters,图像转换过滤器
     * 4) Data compression Filters ，数据转换
     * 5) Encryption Filters ，安全加密
     * 6) Tokenizing Filters ，词法分析
     * 7) Filters that trigger resource access events ，资源访问事件触发过滤器
     * 8) XSL/T filters 
     * 9) Mime-type chain Filter ，文件类型链过滤器

## 四、过滤器（Filter）接口 ##

我们学习过滤器，肯定就要先看一下官方给我们提供的过滤器接口。下面我们使用 Idea 来查看 Filter。

![f82653bca5bb401a97cc6eaf77b1b5cd.png][]

Filter 有如下几个方法：

*  void init(FilterConfig filterConfig) 用于完成过滤器的初始化。
 *  doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) 实现过滤功能，将该方法对每个请求增加额外的处理。
 *  void destroy() 用于过滤器销毁前，完成某些资源的回收。

## 五、使用过滤器（Filter） ##

先自定义 FirstFilter 类实现 Filter 接口：

public class FirstFilter implements Filter {
    
        @Override 
        public void init(FilterConfig filterConfig) throws ServletException {
            Filter.super.init(filterConfig); 
            System.out.println("--------FirstFilter 初始化完成-------"); 
        }
    
        @Override 
        public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse,                         FilterChain filterChain) throws IOException, ServletException {
            System.out.println("------对 First request 进行过滤 --------");
            //下面这行代码就是放行    
            filterChain.doFilter(servletRequest, servletResponse); 
            System.out.println("------对 First response 进行过滤 --------");
        }
    
        @Override public void destroy() {
            Filter.super.destroy(); 
            System.out.println("firstFilter 已销毁"); 
        }
    
    }

再自定义 SecondFilter 类实现 Filter 接口：

public class SecondFilter implements Filter {
    
        @Override 
        public void init(FilterConfig filterConfig) throws ServletException {
            Filter.super.init(filterConfig); 
            System.out.println("--------SecondFilter 初始化完成-------"); 
        }
    
        @Override 
        public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse,                         FilterChain filterChain) throws IOException, ServletException {
            System.out.println("------对 Second request 进行过滤 --------");
            //下面这行代码就是放行
            filterChain.doFilter(servletRequest, servletResponse); 
            System.out.println("------对 Second response 进行过滤 --------");
        }
    
        @Override public void destroy() {
            Filter.super.destroy(); 
            System.out.println("SecondFilter 已销毁"); 
        }
    
    }

再修改 WebConfig 配置类：

@Configuration
    public class WebConfig {
    
        @Bean 
        public FilterRegistrationBean firstFilterRegistrationBean() {
            FilterRegistrationBean<Filter> filterFilterRegistrationBean = new FilterRegistrationBean<>(); 
            // 对哪些路径进行过滤
            filterFilterRegistrationBean.addUrlPatterns("/*");              
            filterFilterRegistrationBean.setOrder(1); // 设置优先级 ,数字越小，优先级越高
            FirstFilter filter = new FirstFilter(); // 绑定过滤器 
            filterFilterRegistrationBean.setFilter(filter); 
            return filterFilterRegistrationBean; 
        }
    
        @Bean 
        public FilterRegistrationBean secondFilterRegistrationBean() {
            FilterRegistrationBean<Filter> filterFilterRegistrationBean = new FilterRegistrationBean<>();
            filterFilterRegistrationBean.addUrlPatterns("/hello");         
            filterFilterRegistrationBean.setOrder(2);  // 设置优先级
            // 绑定过滤器
            SecondFilter filter = new SecondFilter(); 
            filterFilterRegistrationBean.setFilter(filter); 
            return filterFilterRegistrationBean; 
        }
    
    }

启动服务器，然后我们在浏览器中随便输入一个 url 地址进行访问：

浏览器输出： ![4a687b61c7bf419a80282ee5e6a43810.png][]

控制台输出：

------对 First request 进行过滤 ---------
    ------对 First response 进行过滤 --------

> **现在，我们就已经可以得出两个结论了，过滤器并不会管资源是否存在，而只会对配置的拦截路径进行拦截。拦截不仅会对请求进行拦截，而且还会对相应进行拦截。**

## 六、多个 Filter 的执行顺序 ##

上面我们配置了 2 个过滤器，那么我们怎么知道那个过滤器先执行呢？

启动服务器，然后我们浏览器输入 [http://localhost:8080/hello][http_localhost_8080_hello] 来进行访问，查看控制台输出

------对 First request 进行过滤 --------
    ------对 Second request 进行过滤 --------
    ------对 Second response 进行过滤 --------
    ------对 First response 进行过滤 --------

> 我们可以看见 FirstFilter 先进行过滤，然后交给 SecondFilter ，然后访问资源，然后 SecondFilter 对响应进行过滤，然后 FirstFilter 对响应进行过滤。图示如下： ![7847ae6dc0fc44c6850641c5b5c8637f.png][]

## 七、过滤器（Filter）生命周期 ##

Filter 有三个阶段，分别是初始化，拦截和过滤，销毁。

>  *  初始化阶段：web 应用程序启动时，web 服务器将创建 Filter 的实例对象，并调用其 init 方法，完成对象的初始化功能，从而为后续的用户请求作好拦截的准备工作，filter 对象只会创建一次，init 方法也只会执行一次。通过 init 方法的参数，可获得代表当前 filter 配置信息的 FilterConfig 对象（永远只调用一次）
>  *  拦截和过滤阶段：只要请求资源的路径和拦截的路径相同，那么过滤器就会对请求进行过滤，这个阶段在服务器运行过程中会一直循环，不管第几次，都在调用doGet()，doPost() 方法之前。
>  *  销毁阶段：当服务器（Tomcat）关闭时，Web 容器调用 destroy 方法销毁 Filter。destroy 方法在 Filter 的生命周期中仅执行一次。在 destroy 方法中，可以释放过滤器使用的资源(永远只调用一次)；

## 八、FilterConfig 和 FilterChain 说明 ##

FilterConfig 和 FilterChain 这2个对象是由服务器 (Tomcat) 在创建和调用 Filter 对象时所传入的，这2个对象十分有用，FilterConfig 对象可以读取我们配置的初始参数，FilterChain 可以实现多个 Filter 之间的连接。

### 1、FilterConfig ###

先看一下源码：

public interface FilterConfig {
        String getFilterName();
    
        ServletContext getServletContext();
    
        String getInitParameter(String var1);
    
        Enumeration<String> getInitParameterNames();
    }

里面的方法就 4 个，下面我们分别进行讲解

*  getFilterName()：获取 filter 的名称
 *  getServletContext()：获取 ServletContext
 *  getInitparamter(String var1)：获取配置的初始参数的值
 *  getInitParamterNames()：获取配置的所有参数名称

### 2、FilterChain ###

先看一下源码

public interface FilterChain {
        void doFilter(ServletRequest var1, ServletResponse var2) throws IOException, ServletException;
    }

> 我们查看源码，可以发现 FilterChain 就只有一个方法，其实这个方法就是用来对拦截进行放行的，如果有多个拦截器，那么就会继续调用下一个 Filter 进行拦截。doFilter 方法需要传入个参数，一个是 ServletRequest，一个是 ServletResponse 参数，这个直接传入进行。
> 
> Tomcat 在调用过滤器时，默认就会传入 Request 和 Response，这个参数封装了请求和响应，我们直接使用就行。ServletResquest 和 ServletResponse 可以直接强转成 HttpServletRequest 和 HttpServletResponse，然后使用相应的方法。

将 ServletRequest 转成 HttpServletRequest

@Override 
        public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse,                         FilterChain filterChain) throws IOException, ServletException {
           
            HttpServletRequest httpServletRequest = (HttpServletRequest) servletRequest;
            
        }

## 九、参考文档 ##

[JavaWeb 过滤器 (Filter) 详解][JavaWeb _ _Filter_]

[6a561fd966b04cf58193f70d6aa66eb0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/01/55548997fc764bdd9351637012ca9c29.png
[f82653bca5bb401a97cc6eaf77b1b5cd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/01/0def5191891842419284f2ae8ccc9db8.png
[4a687b61c7bf419a80282ee5e6a43810.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/01/6fd34e0df32f42839ec3d1ff4ebac365.png
[http_localhost_8080_hello]: http://localhost:8080/hello
[7847ae6dc0fc44c6850641c5b5c8637f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/01/14e7cc177ad343619263a1409e242884.png
[JavaWeb _ _Filter_]: https://blog.csdn.net/m0_51545690/article/details/123677340