SpringAOP:面向切面编程

大家好，这依旧是一篇个人笔记，关于SpringAOP的笔记

笔记内容来源于黑马Web课程133~139集

本篇笔记由WorkBuddy一起辅助完成，不喜勿喷，谢谢！

一、Spring AOP 整体思路

Spring AOP（Aspect Oriented Programming，面向切面编程）是一种编程思想，核心思想是：在不修改原有业务代码的情况下，为指定的方法统一添加额外的通用功能。

1.1 AOP 核心思想

AOP 的本质是「面向方法编程」，通过「切面」将「额外功能」与「作用范围」结合起来：

• • 切面（Aspect）：额外功能 + 作用范围的组合
• • 额外功能：如统计耗时、日志记录、权限校验等通用逻辑
• • 作用范围：通过切入点表达式指定哪些方法需要添加额外功能

总结：AOP编程思想“面向切面”或者“面向方法”编程本质上就是给“你规定的一系列方法”加上“额外功能”

所谓“切面”就是指“额外功能”+“作用范围”（就是我规定的哪些方法）

以上面图片为例：本质上就是给“业务层的方法”添加“计算耗时”这个额外功能

1.2 AOP 执行流程

AOP 的执行基于「动态代理」机制：

二、Spring AOP 基础

2.1 AOP 快速入门

2.1.1 场景需求

统计所有业务层方法的执行耗时，用于性能分析和优化。

2.1.2 实现步骤

步骤一：引入 AOP 依赖（pom.xml）

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>

步骤二：编写切面类

@Aspect // 标明这是一个 AOP 类 @Component // 纳入 Spring 容器管理 public class RecordTimeAspect { @Around("execution(* com.itheima.service.impl.*.*(..))") public Object recordTime(ProceedingJoinPoint pjp) throws Throwable { // 1. 记录开始时间 long begin = System.currentTimeMillis(); // 2. 执行目标方法 Object result = pjp.proceed(); // 3. 记录结束时间并计算耗时 long end = System.currentTimeMillis(); log.info("方法执行耗时: {} ms", end - begin); return result;

2.2 AOP 核心概念

2.3 AOP 的优势

• • 减少重复代码：通用逻辑统一维护
• • 代码无侵入：不修改原有业务代码
• • 提高开发效率：复用通用功能
• • 维护方便：修改一处，全局生效

三、Spring AOP 进阶

3.1 通知类型

根据通知方法执行时机的不同，分为以下五类：

⚠️ 注意事项：

• • @Around 环绕通知需要自己调用 ProceedingJoinPoint.proceed() 来执行目标方法
• • @Around 环绕通知方法的返回值必须指定为 Object，用于接收目标方法的返回值

3.2 通知顺序

3.2.1 默认顺序

当多个切面的切入点都匹配到目标方法时，默认按照切面类的「类名字母顺序」排序：

• • 目标方法前的通知：字母排名靠前的先执行
• • 目标方法后的通知：字母排名靠前的后执行

3.2.2 自定义顺序（@Order）

使用 @Order(数字) 注解控制执行顺序，数字越小越先执行：

@Order(5) // 先执行 @Aspect @Component public class MyAspect3 {@Before("execution(* com.itheima.service.impl.*.*(..))")public void before(){ log.info("MyAspect3 -> before ..."); } @Order(8) // 后执行 @Aspect @Component public class MyAspect2 {@Before("execution(* com.itheima.service.impl.*.*(..))")public void before(){ log.info("MyAspect3 -> before ..."); }

3.3 切入点表达式

3.3.1 execution 表达式

execution 是最常用的切入点表达式，语法如下：

execution(访问修饰符? 返回值 包名.类名.?方法名(方法参数) throws 异常?)

通配符说明：

常用示例：

// 匹配 service 包下所有类的所有方法 execution(* com.itheima.service.*.*(..)) // 匹配所有以 del 开头的方法 execution(* com.itheima.service.*.del*(..)) // 匹配所有以 e 结尾的方法 execution(* com.itheima.service.*.*e(..)) // 同时匹配多个方法（使用 || 运算符） execution(* com.itheima.service.*.list(..)) || execution(* com.itheima.service.*.delete(..))

书写建议：

• • 所有业务方法名命名时尽量规范，方便切入点表达式快速匹配
• • 描述切入点方法通常基于接口描述，增强拓展性
• • 在满足业务需要的前提下，尽量缩小切入点的匹配范围

3.3.2 @annotation 表达式

基于自定义注解标记方法，而非直接写方法路径，更加灵活：

补充一下关于annotation切入点表达式的理解：本质上就是定义了一个自己想要的注解，然后再切面类的通知方法里面绑定归属于哪一个自己定义的注解

步骤一：定义自定义注解

步骤二：切面类绑定注解

步骤三：在目标方法上使用注解

3.3.3 @PointCut 抽取公共切入点

将公共的切入点表达式抽取出来，提高复用性：

（PointCut：对于公共切入点（方法路径）的简化；作用就像是springboot里面RequestMapping公共路径书写的作用）

@Pointcut("execution(* com.itheima.service.impl.*.*(..))") private void pt() {} // private：仅当前切面类可用 @Around("pt()") public Object around(ProceedingJoinPoint pjp) throws Throwable { // 通知逻辑 }

注意：

• private：仅能在当前切面类中引用该表达式

• public：在其他外部的切面类中也可以引用该表达式

3.4 连接点 JoinPoint

就是你要在Aspect类里面执行原方法的内容就必须用到这个JointPoint

在 Spring 中用 JoinPoint 抽象了连接点，可以获得方法执行时的相关信息：

注意：

• •对于 @Around 通知，获取连接点信息只能使用 ProceedingJoinPoint
• • 对于其他四种通知，获取连接点信息使用 JoinPoint（ProceedingJoinPoint 的父类）

四、Spring AOP 案例

4.1 案例：记录操作日志

将增、删、改相关接口的操作日志记录到数据库表中。

4.1.1 日志信息内容

• • 操作人：当前登录员工的 ID
• • 操作时间：方法执行的时间
• • 执行方法的全类名、方法名
• • 方法运行时参数、返回值
• • 方法执行时长

4.1.2 技术方案

4.2 案例：获取当前登录员工

通过 ThreadLocal 在拦截器和切面之间传递当前登录员工信息。

4.2.1 实现思路

输出操作人实现思路：操作的时候需要登陆认证，会产生JWT令牌，之前我们定义的JWT令牌自定义了信息“id”，而这个id可以唯一标识每一个员工，因此获取到这个id就相当于知道操作人是谁了

• • 登录时生成 JWT 令牌，包含员工 ID
• • 拦截器解析 Token，将员工 ID 存入 ThreadLocal
• • 切面类从 ThreadLocal 获取操作人 ID
• • 请求结束后清除 ThreadLocal（防止内存泄漏）

4.2.2 ThreadLocal 工具类

先准备这个线程类，每次请求的数据都会保存在独立的一次线程中，保证了获取到的数据就是那次请求的数据

4.2.3 拦截器设置 ThreadLocal

@Component public class TokenInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token = request.getHeader("token"); Claims claims = JwtUtils.parseToken(token); Integer employeeId = Integer.valueOf(claims.get("id").toString()); CurrentHolder.setCurrentId(employeeId); // 存入 ThreadLocal return true; } @Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { CurrentHolder.remove(); // 清除 ThreadLocal } }

4.2.4 切面类获取操作人

@Around("@annotation(com.example.tlias_management.anno.Log)") public Object recordLog(ProceedingJoinPoint joinPoint) throws Throwable { // 从 ThreadLocal 获取操作人 ID Integer operateEmpId = CurrentHolder.getCurrentId(); // 其他日志信息... LocalDateTime operateTime = LocalDateTime.now(); String className = joinPoint.getTarget().getClass().getName(); String methodName = joinPoint.getSignature().getName(); // 执行目标方法 Object result = joinPoint.proceed(); // 保存日志到数据库... return result;

五、知识总结

5.1 核心概念回顾

5.2 常用注解

5.3 切入点表达式

5.4 注意事项

• • @Around 必须调用 proceed() 执行目标方法
• • @Around 返回值必须是 Object
• • 使用 ThreadLocal 后一定要在 afterCompletion 中 remove()
• • 切入点表达式尽量缩小匹配范围，提高性能