当前位置： 首页 > news >正文

【Springboot】Filter 过滤器的使用

news 2025/6/29 3:42:47

一、基本介绍

        过滤器 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 资源再次进行过滤处理。

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

三、过滤器的作用

 * 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。

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 地址进行访问：

浏览器输出： 

控制台输出：

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

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

六、多个 Filter 的执行顺序

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

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

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

我们可以看见 FirstFilter 先进行过滤，然后交给 SecondFilter ，然后访问资源，然后 SecondFilter 对响应进行过滤，然后 FirstFilter 对响应进行过滤。图示如下：  

七、过滤器（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) 详解

http://www.lryc.cn/news/194779.html

相关文章：

  • 力扣-461.汉明距离
  • GEE 18：基于GEE平台的土地荒漠化监测与分析【论文复现】
  • 平台系统老板驾驶舱的重要性，我选云表
  • 【SpringMVC篇】探索请求映射路径，Get请求与Post请求
  • vqvae简单实战，利用vqvae来提升模型向量表达
  • idea禁用双击ctrl
  • 记使用docker部署项目出现问题
  • EDU挖掘
  • 机器人制作开源方案 | 杠杆式6轮爬楼机器人
  • 报错——warning: ignoring JAVA_HOME=/home/jdk/jdk1.8.0_281； using bundled JDK
  • 【Java8】java.time 根据日期获取年初年末、月初月末、日初日末
  • 【LeetCode: 137. 只出现一次的数字 II | 位运算 | 哈希表】
  • 「深入探究Web页面生命周期：DOMContentLoaded、load、beforeunload和unload事件」
  • SpringMVC源码分析（一）启动流程分析
  • ARM 10.12
  • vue-rouer 路由
  • 元数据的前世今生
  • Python实现简易过滤删除数字的方法
  • 软件测试定位bug方法+定位案例（详解）
  • 【算法练习Day21】组合剪枝
  • NPM相关命令
  • Kubernetes 集群部署 Prometheus 和 Grafana
  • 【算法-动态规划】零钱兑换 II-力扣 518
  • Hadoop3教程（六）：HDFS中的DataNode
  • Macos音乐制作：Ableton Live 11 Suite for Mac中文版
  • ThinkPHP5小语种学习平台
  • 升级包版本之后Reflections反射包在springboot jar环境下扫描不到class排查过程记录
  • Excel 函数大全应用，包含各类常用函数
  • 深入浅出的介绍一下虚拟机VMware Workstation——part3(VMware快照)
  • 《Python基础教程》专栏总结篇