【Spring Boot 3】自定义拦截器
- 背景
- 介绍
- 开发环境
- 开发步骤及源码
- 工程目录结构
- 总结
背景
软件开发是一门实践性科学,对大多数人来说,学习一种新技术不是一开始就去深究其原理,而是先从做出一个可工作的DEMO入手。但在我个人学习和工作经历中,每次学习新技术总是要花费或多或少的时间、检索不止一篇资料才能得出一个可工作的DEMO,这占用了我大量的时间精力。因此本文旨在通过一篇文章即能还原出可工作的、甚至可用于生产的DEMO,期望初学者能尽快地迈过0到1的这一步骤,并在此基础上不断深化对相关知识的理解。
为达以上目的,本文会将开发环境、工程目录结构、开发步骤及源码尽量全面地展现出来,文字描述能简则简,能用代码注释的绝不在正文中再啰嗦一遍,正文仅对必要且关键的信息做重点描述。
介绍
本文介绍开发 Spring Boot 应用如何自定义拦截器(Interceptor)实现。
Spring Boot 拦截器(Interceptor)基于 Java 反射机制实现,可以对 Controller 中方法进行拦截,并在方法执行前后进行相应处理,是基于切面编程(AOP)的一种模式。拦截器(Interceptor)通常的应用场景包括:
- 权限校验
- 日志记录
- 性能监控
拦截器(Interceptor)通常拿来与过滤器(Filter)进行比较,虽然它们在应用上存在诸多重叠,但实现原理完全不同。过滤器基于 Servlet 规范,可对所有 Servlet 请求进行预处理或后处理。过滤器(Filter)通常的应用场景包括:
- 编码转换
- 安全校验
- 请求链路跟踪
拦截器(Interceptor)与过滤器(Filter)的关键区别:
- 过滤器(Filter)主要作用在 Servlet 生命周期的各环节中,用于处理网络请求;
- 拦截器(Interceptor)作用范围不局限于网络请求,作用于具体业务方法,粒度更细。
从下图中可以看出拦截器(Interceptor)与过滤器(Filter)的作用顺序。
开发环境
分类 | 名称 | 版本 |
---|---|---|
操作系统 | 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.