Java可通过自定义组合注解将多个常用注解打包，核心是用@interface定义并标注元注解，配合@Retention、@Target和@AliasFor实现属性映射与运行时识别。
Java 中可以通过自定义组合注解（Meta-Annotation）把多个常用注解打包成一个，从而简化重复声明。核心是使用 @interface 定义新注解，并在其上标注其他注解（即“元注解”），同时用 @Retention、@Target 等声明其生命周期和作用位置。
组合注解的基本写法
要让一个注解能“包含”其他注解，关键在于：它本身被其他注解标注（如 @Component、@Scope、@Transactional），且这些注解必须支持作为元注解（即它们自己声明了 @Retention(RetentionPolicy.RUNTIME) 和 @Target，且通常还加了 @Documented）。
例如，把 Spring 中常用的控制器层注解合并为一个：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Component
@RequestMapping
public @interface RestApiController {
@AliasFor(annotation = Component.class, attribute = "value")
String value() default "";
@AliasFor(annotation = RequestMapping.class, attribute = "path")
String[] path() default {};
@AliasFor(annotation = RequestMapping.class, attribute = "method")
RequestMethod[] method() default {};
}
这里用了 @AliasFor 实现属性映射，使 @RestApiController("user") 同时等价于 @Component("user") 和 @RequestMapping(path = "user")。
立即学习“Java免费学习笔记（深入）”；
必须注意的几个前提条件
- 被组合的注解（如
@Component、@Transactional）本身必须是可重复用作元注解的 —— 查看源码确认它有@Retention(RUNTIME)和合适的@Target（比如@Target({ElementType.TYPE, ElementType.METHOD})） - 若想转发属性（如把组合注解的
value()映射到@Component的value），必须用@AliasFor显式声明，否则不会自动传递 - Spring 5.2+ 对
@AliasFor支持更完善，旧版本可能需保证成对出现或使用单向别名 - 组合注解自身也要声明
@Retention和@Target，否则运行时无法读取，框架也识别不到
常见实用组合示例
✅ 替代 @RestController + @RequestMapping：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@RestController
@RequestMapping
public @interface RestApi {
@AliasFor(annotation = RequestMapping.class, attribute = "path")
String[] value() default {};
}
✅ 简化带事务和异常处理的 Service：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Service
@Transactional(rollbackFor = Exception.class)
public @interface TxService {
@AliasFor(annotation = Service.class, attribute = "value")
String value() default "";
}
使用时只需 @TxService("orderService")，就同时具备服务注册、默认事务（异常回滚）能力。
组合注解不是“继承”，而是“元数据叠加”
组合注解不会生成新行为，它只是让 JVM 和框架在处理目标元素（类/方法）时，**同时看到多个注解的元数据**。Spring 的 AnnotationUtils 和 AnnotatedElementUtils 能自动解析嵌套结构，所以 @RestApi 类会被 Spring 同时识别为 @RestController 和 @RequestMapping 类型。
但要注意：如果两个被组合的注解对同一行为有冲突（如都定义了 timeout 且值不同），实际生效的取决于框架解析顺序，一般不建议在组合注解里混用语义重叠的配置项。
