【Spring Boot 3】【Web】自定义过滤器
背景 介绍 开发环境 开发步骤及源码 工程目录结构 总结
背景
软件开发是一门实践性科学，对大多数人来说，学习一种新技术不是一开始就去深究其原理，而是先从做出一个可工作的DEMO入手。但在我个人学习和工作经历中，每次学习新技术总是要花费或多或少的时间、检索不止一篇资料才能得出一个可工作的DEMO，这占用了我大量的时间精力。因此本文旨在通过一篇文章即能还原出可工作的、甚至可用于生产的DEMO，期望初学者能尽快地迈过0到1的这一步骤，并在此基础上不断深化对相关知识的理解。
为达以上目的，本文会将开发环境、工程目录结构、开发步骤及源码尽量全面地展现出来，文字描述能简则简，能用代码注释的绝不在正文中再啰嗦一遍，正文仅对必要且关键的信息做重点描述。
介绍
本文介绍开发 Spring Boot 应用如何自定义过滤器（Filter）实现。
Spring Boot 过滤器（Filter）基于 Servlet 规范实现，可以对网络请求进行拦截，并在请求执行前后进行相应处理。过滤器（Filter）通常的应用场景包括：
编码转换 安全校验 请求链路跟踪过滤器（Filter）通常拿来与拦截器（Interceptor）进行比较，虽然它们在应用上存在诸多重叠，但实现原理完全不同。Spring Boot 拦截器（Interceptor）基于 Java 反射机制实现，可以对 Controller 中方法进行拦截，并在方法执行前后进行相应处理，是基于切面编程（AOP）的一种模式。拦截器（Interceptor）通常的应用场景包括：
权限校验 日志记录 性能监控过滤器（Filter）与拦截器（Interceptor）的关键区别：
过滤器（Filter）主要作用在 Servlet 生命周期的各环节中，用于处理网络请求； 拦截器（Interceptor）作用范围不局限于网络请求，作用于具体业务方法，粒度更细。从下图中可以看出过滤器（Filter）与拦截器（Interceptor）的作用顺序。
开发环境
| 分类 | 名称 | 版本 |
|---|---|---|
| 操作系统 | Windows | Windows 11 |
| JDK | Oracle JDK | 21.0.1 |
| IDE | IntelliJ IDEA | 2023.3.7 |
| 构建工具 | Apache Maven | 3.9.9 |
开发步骤及源码
1> 创建Maven工程，添加依赖。
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.jiyongliang</groupId> <artifactId>springboot3-web</artifactId> <version>0.0.1</version> </parent> <artifactId>springboot3-web-filter</artifactId>