【Spring Boot 3】【Web】自定义过滤器

又言又语

已于 2024-08-29 07:24:52 修改

阅读量1.1k

点赞数 20

分类专栏： Spring 文章标签： spring boot 过滤器 Filter

于 2024-08-28 23:16:47 首次发布

本文链接：https://blog.csdn.net/Silent_Paladin/article/details/141651876

版权

【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>