SpringBoot项目中注解使用规范

1.springboot AOP默认使用cglib代理

aop为何一直使用cglib代理的原因:

spring boot项目启动类上有一@SpringBootApplication注解,这是一套组合注解:注解内部的定义,找到@EnableAutoConfiguration,再找到@Import(AutoConfigurationImportSelector.class)

AutoConfigurationImportSelector类的process方法,AopAutoConfiguration类的主要任务是根据配置参数使用注解@EnableAspectJAutoProxy

而:该类启用的条件是:配置参数spring.aop.auto值不为false,我们的spring-configuration-metadata.json中有配置:当spring.aop.proxy-target-class缺省配置时默认也是true,spring-boot里面默认就是true,所以默认使用aop的cglib代理。

2.为什么springBoot中,注解在私有方法上,或者内部调用的方法上,无法生效原因解析

  1. 注解是借助Spring AOP实现

  2. spring aop默认都是采用java的动态代理,其次才会使用cglib代理

为什么不能在私有方法上注解:

如果从aop的角度去分析,那么答案就是:因为cglib

原因:cglib实现动态代理,其底层采用了ASM字节码生成框架,直接对需要代理的类的字节码进行操作,生成这个类的一个子类,并重写了类的所有可以重写的方法。

由于cglib的代理类使用的是继承,这也就意味着cglib不能代理final类,同时也不能对private方法进行代理!子类无法重写private方法!

aop不支持对private私有方法的拦截,所以也就不支持私有方法上的注解

为什么 类内部方法调用不支持 如果是类内部方法调用,为什么就不能生效?

注解了的类是被cglib重新增强代理过的类。类内部方法互调,相当于this.function()的调用模式,这里的this是类本身,并不是被代理的类,所以不走代理,注解不生效。

综上所述 :springboot默认使用cglib代码,cglib为类生成子类,进行增强,所以不会重写父类的private的类,所以注解在私有方法上不生效。其次,类内部的方法调用,用的是this.function()的形式,其中this是类本身,不是被代理的类,所以类内部方法调用,注解不会生效。

3.注解在CGLIB代理中的表现

  1. 注解的位置:注解可以放在目标类的各个方法上,包括 public、protected、default 和 private 方法。

  2. 代理机制的影响

  • 公共方法 (public):这些方法可以通过代理对象正常访问,并且注解也会被正确识别和处理。
  • 非公共方法 (protected, default, private):这些方法只能通过原生对象访问,而不是通过代理对象。因此,如果在这些方法上调用了带有注解的操作(如事务管理、异步执行等),注解的效果可能会受到影响。

4.解决方案

  1. 重构方法结构:将需要特殊处理的方法移到一个新的类中,并使其成为 public 或 protected 方法。
  2. 使用AopContext获取代理对象:如果必须保持单一类的设计,可以使用 AopContext.currentProxy() 获取当前代理对象,然后通过该代理对象调用方法。

总结:

  • 注解可以放置在类内部的各种方法上,包括 private 方法。

  • CGLIB代理会影响非公共方法的注解解析,只有通过代理对象调用的方法才能正确响应注解。

  • 建议将需要特殊处理的方法提取到新的类中,或者使用 AopContext.currentProxy() 获取代理对象来确保注解的有效性。

推荐阅读:

https://zhuanlan.zhihu.com/p/452611889

相关推荐
葫芦和十三4 小时前
图解 MongoDB 19|Oplog:复制的真正载体,不是文档是操作
后端·mongodb·agent
葫芦和十三4 小时前
图解 MongoDB 20|复制延迟与 catch up:Secondary 为什么跟不上
后端·mongodb·agent
IT_陈寒8 小时前
SpringBoot自动配置的坑,我的API突然就404了
前端·人工智能·后端
ServBay9 小时前
为什么说 MCP 是 2026 年开发者必须掌握的黄金协议?
后端·mcp
程序员夏洛9 小时前
Spring Boot 多模块项目中 IDEA 提示 Cannot resolve symbol 的一次排查记录
后端
子兮曰9 小时前
OpenMontage 深度解剖:你的 AI 编程助手,其实是个视频工作室
前端·后端·ai编程
子兮曰9 小时前
前端工具链的「Rust 化」:一场没有赢家的军备竞赛?
前端·后端·rust
爱勇宝11 小时前
从 Ctrl+CV 到 Enter:程序员正在失去什么
前端·后端·程序员
码事漫谈11 小时前
EdgeOne Makers + WorkBuddy:零基础也能快速搭建可上线的 AI 智能体(附图文教程)
后端