Spring AOP 中 JoinPoint 使用详解

更新时间：2026年02月11日 09:35:03 作者：Knight_AL

JoinPoint是Spring AOP中获取方法运行时信息的核心接口,可以获取方法参数、类名、方法名、Method对象、注解等,下面就来介绍一下Spring AOP JoinPoint 使用,感兴趣的可以了解一下

一、什么是 JoinPoint？
二、JoinPoint 能获取哪些信息？
三、获取方法参数（最常用）
四、获取类名 + 方法名
五、获取 Method 对象（获取注解的必备步骤）
六、获取方法上的注解（非常常用）
七、完整示例：通过 JoinPoint 实现幂等签名生成
八、JoinPoint 的典型应用场景
九、总结

一、什么是 JoinPoint？

在 Spring AOP 中，JoinPoint 表示的是：

一个方法执行的切入点（连接点），包含当前方法调用的全部运行时信息。

你可以把它理解成：

Spring AOP 告诉你：我要执行这个方法了，你要不要看看它是谁？参数是什么？类是谁？用的是什么注解？

二、JoinPoint 能获取哪些信息？

能获取的内容	使用方法
方法参数	joinPoint.getArgs()
目标对象（真实类）	joinPoint.getTarget()
代理对象（AOP 生成）	joinPoint.getThis()
方法名	joinPoint.getSignature().getName()
类名	joinPoint.getTarget().getClass()
方法签名	MethodSignature
方法本体 Method	((MethodSignature) jp.getSignature()).getMethod()
方法上的注解	method.getAnnotation(XXX.class)

这些能力构成了 AOP 一切高级玩法：幂等、防重复提交、权限校验、操作日志、审计…… 全靠 JoinPoint 取参数和注解。

三、获取方法参数（最常用）

Object[] args = joinPoint.getArgs();
System.out.println(JSON.toJSONString(args));

输出：

[{"name":"Tom","age":18}]

适用场景：

接口日志打印
幂等签名（根据参数生成 Key）
参数校验
审计记录

四、获取类名 + 方法名

String className = joinPoint.getTarget().getClass().getName();
String methodName = joinPoint.getSignature().getName();

System.out.println(className + "." + methodName);

输出：

com.demo.controller.UserController.createOrder

适用场景：

记录接口访问日志
记录方法调用来源
记录操作审计行为

五、获取 Method 对象（获取注解的必备步骤）

JoinPoint 获取 Method 的正确方式：

MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();

拿到 Method 后你可以做什么？

六、获取方法上的注解（非常常用）

在幂等、权限控制、操作日志等 AOP 场景中，你都会在方法上写注解：

@PostMapping("/order/create")
@RepeatSubmit(interval = 5000)
public R createOrder(@RequestBody OrderDTO dto) {
    return R.ok();
}

在 AOP 内获取注解：

RepeatSubmit repeatSubmit = method.getAnnotation(RepeatSubmit.class);
int interval = repeatSubmit.interval();

这就是 AOP 注解驱动业务的核心。

七、完整示例：通过 JoinPoint 实现幂等签名生成

@Before("@annotation(repeatSubmit)")
public void before(JoinPoint joinPoint, RepeatSubmit repeatSubmit) {

    // 获取 URI
    HttpServletRequest request =
        ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
    String uri = request.getRequestURI();

    // 获取参数
    String params = JSON.toJSONString(joinPoint.getArgs());

    // 获取方法本体
    MethodSignature signature = (MethodSignature) joinPoint.getSignature();
    Method method = signature.getMethod();

    // 获取注解内容
    RepeatSubmit anno = method.getAnnotation(RepeatSubmit.class);
    long interval = anno.interval();

    System.out.println("访问接口：" + uri);
    System.out.println("参数：" + params);
    System.out.println("注解配置间隔：" + interval + " ms");
}

输出类似：

这就是 JoinPoint 在幂等逻辑中最常用的三件事：

获取参数
获取方法信息
获取注解配置

八、JoinPoint 的典型应用场景

场景	JoinPoint 的作用
防重复提交（幂等）	获取参数 + 获取注解配置
业务操作日志	获取类名、方法名、参数
统一异常记录	获取方法名、参数
接口权限校验	获取注解权限标识
慢接口报警	方法计时
分布式锁标识生成	参数签名

说白了：

只要你需要知道“当前被调用的方法是哪个？参数是什么？注解是什么？”就必须用 JoinPoint。

九、总结

JoinPoint 是 Spring AOP 中获取方法运行时信息的核心接口
它能获取方法参数、类名、方法名、Method 对象、注解
是参数校验、日志、幂等、防重复提交、权限控制等 AOP 功能的基础
获取注解必须先通过 MethodSignature 得到 Method
幂等、防重复提交中最常用的能力就是：joinPoint.getArgs() + 获取注解配置

一句话总结：

JoinPoint 是 AOP 的“方法上下文”。只要你需要基于注解或参数做业务，就离不开它。

到此这篇关于Spring AOP 中 JoinPoint 使用详解的文章就介绍到这了,更多相关Spring AOP JoinPoint 使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

浅析Java中print、printf、println的区别
以下是对Java中print、printf、println的区别进行了详细的分析介绍，需要的朋友可以过来参考下
2013-08-08
SpringBoot项目打成war和jar的区别说明
这篇文章主要介绍了SpringBoot项目打成war和jar的区别说明，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-06-06
java实现字符串匹配求两个字符串的最大公共子串
这篇文章主要介绍了java实现求两个字符串最大公共子串的方法，详细的描述了两个字符串的最大公共子串算法的实现,需要的朋友可以参考下
2016-10-10
Java中实现日志记录的方案总结
在平时使用到一些软件中,比如某宝或者某书,通过记录用户的行为来构建和分析用户的行为数据,这就需要使用到日志系统来存储或者记录数据,小编为大家整理了几种Java日志方案,希望对大家有所帮助
2024-12-12
mybatis generator 配置反向生成Entity简单增删改查(推荐)
这篇文章主要介绍了mybatis generator 配置反向生成Entity简单增删改查(推荐)的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-12-12
spring @Cacheable扩展实现缓存自动过期时间及自动刷新功能
用过spring cache的朋友应该会知道,Spring Cache默认是不支持在@Cacheable上添加过期时间的,虽然可以通过配置缓存容器时统一指定,本文主要介绍了如何基于spring @Cacheable扩展实现缓存自动过期时间以及缓存即将到期自动刷新,
2024-02-02
使用maven构建java9 service实例详解
本篇文章主要介绍了使用maven构建java9 service实例详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-02-02
Spring Boot整合Thymeleaf详解
这篇文章主要介绍了Spring Boot整合Thymeleaf详解，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-08-08
IDEA2022创建Maven Web项目教程(图文)
本文主要介绍了IDEA2022创建Maven Web项目教程，文中通过图文介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-07-07
Springboot指定扫描路径的实现示例
本文主要介绍了Springboot指定扫描路径的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-05-05