Spring AOP：切点表达式

在 Spring AOP 中，Pointcut（切点） 用于定义哪些 连接点（Join Points） 会被切面增强。切点表达式通过特定的语法描述目标方法的特征，例如方法名、参数类型、返回值、类路径等。以下是 Pointcut 表达式的核心语法和常见用法：

一、Pointcut 表达式语法

Pointcut 表达式的基本结构为：

execution(modifiers-pattern? ret-type-pattern declaring-type-pattern?name-pattern(param-pattern) throws-pattern?)

其中：

• modifiers-pattern：方法的修饰符（如 public、static）。
• ret-type-pattern：返回值类型（如 String、int）。
• declaring-type-pattern：声明方法的类或接口。
• name-pattern：方法名（支持通配符 *）。
• param-pattern：参数类型列表（支持通配符 .. 表示任意参数）。
• throws-pattern：抛出的异常类型。

二、常见 Pointcut 表达式示例

1. 匹配所有方法（最宽泛）

execution(* *(..))

• 含义：匹配所有类的所有方法。
• 示例场景：全局日志记录。

2. 匹配特定类的方法

execution(* com.example.service.*.*(..))

• 含义：匹配 com.example.service 包下所有类的所有方法。
• 通配符：
  • *：匹配任意字符（类名、方法名）。
  • ..：匹配任意参数列表或子包。

3. 匹配特定方法名

execution(* com.example.service.UserService.find*(..))

• 含义：匹配 UserService 类中所有以 find 开头的方法。
• 示例：findById, findAll。

4. 匹配特定参数类型

execution(* com.example.service.*.*(String, int))

• 含义：匹配参数为 String 和 int 的方法。
• 通配符：
  • ..：匹配任意参数（如 execution(* *(..))）。

5. 匹配返回值类型

execution(String com.example.service.*.*(..))

• 含义：匹配返回值类型为 String 的方法。

6. 匹配特定注解的方法

@annotation(com.example.annotation.Loggable)

• 含义：匹配带有 @Loggable 注解的方法。
• 示例：在方法上添加 @Loggable，切面会记录日志。

7. 匹配特定类或接口的成员

within(com.example.service.*)

• 含义：匹配 com.example.service 包下所有类的方法。
• 与 execution 的区别：within 只关注类/包，不关注方法签名。

8. 组合表达式（逻辑运算符）

execution(* com.example.service.*.*(..)) && !within(com.example.service.util*)

• 含义：匹配 com.example.service 包下所有方法，但排除 util 子包中的方法。
• 逻辑运算符：
  • &&：与（AND）
  • ||：或（OR）
  • !：非（NOT）

三、XML 配置中的 Pointcut 表达式

在 XML 中，Pointcut 表达式通过 <aop:pointcut> 标签定义，并关联到切面逻辑。

示例：匹配 Service 层方法并记录日志

<aop:config>
    <!-- 定义切点 -->
    <aop:pointcut id="serviceMethods" 
                  expression="execution(* com.example.service..*.*(..))"/>
    
    <!-- 定义通知 -->
    <aop:aspect ref="loggingAspect">
        <aop:before pointcut-ref="serviceMethods" method="logBefore"/>
        <aop:afterReturning pointcut-ref="serviceMethods" method="logReturn"/>
    </aop:aspect>
</aop:config>

四、常用匹配模式总结

五、调试技巧

1. 使用通配符 ..：
   • 在包路径或参数列表中使用 .. 可以简化表达式（如 com.example..* 匹配 com.example 及其子包）。
2. 测试切点匹配：
   • 在应用启动时输出切点匹配的方法列表（需启用调试日志）。
3. 避免过度匹配：
   • 使用精确的包路径和方法签名，避免切入点范围过大。

六、常见错误

1. 语法错误：
   • 错误使用通配符（如 execution(* com.example.service.*) 缺少方法参数匹配）。
2. 逻辑运算符优先级：
   • && 优先级高于 ||，建议使用括号明确优先级（如 (A || B) && C）。
3. 注解未生效：
   • 确保注解的 @Retention 设置为 RUNTIME，且切面配置正确。

通过灵活使用 Pointcut 表达式，可以精准控制切面的切入范围，实现日志、事务、权限等横切关注点的模块化管理。