getdeclaredannotations()直接返回方法自身声明的所有注解数组,不包含继承注解、不解析元注解、不展开@repeatable容器;需用getdeclaredannotationsbytype()获取重复注解实例。

Method.getDeclaredAnnotations() 本身就能一次性获取方法上**所有直接声明的注解**(即该方法上显式写上的注解),不需要额外“抓取”或循环处理。关键在于理解它的行为边界和常见误区。
它返回什么?
返回一个 Annotation[] 数组,包含该方法**自身声明的所有注解**,不包含继承自接口、父类或超类的注解,也不检查注解是否被 @Inherited 标记(因为 @Inherited 对方法无效)。
例如:
@Deprecated
@Scheduled(cron = "0 * * * * ?")
public void doTask() { ... }
调用 doTaskMethod.getDeclaredAnnotations() 会直接返回长度为 2 的数组,含 @Deprecated 和 @Scheduled 实例。
注意:它不解析元注解,也不递归展开
getDeclaredAnnotations() 只拿“贴在方法上”的注解,不管这些注解自己有没有被其他注解标记(比如 @Retention、@Target)。它也不会自动识别并加载被 @Repeatable 容器包裹的重复注解——除非你用的是 getDeclaredAnnotationsByType()。
- 如果用了
@MyAnn+@Repeatable(MyAnns.class),且方法上写了两个@MyAnn,那么:getDeclaredAnnotations()返回的是MyAnns容器实例(1 个),不是两个MyAnn;
想直接拿到所有MyAnn实例,请改用method.getDeclaredAnnotationsByType(MyAnn.class)。
怎么安全遍历/使用返回的注解?
拿到数组后可直接 for-each,但建议先判空(虽然通常不为空,除非没写任何注解):
Annotation[] anns = method.getDeclaredAnnotations();
for (Annotation ann : anns) {
System.out.println(ann.annotationType().getSimpleName()); // 如 "Scheduled"
// 用反射读具体属性,例如:
if (ann instanceof Scheduled scheduled) {
System.out.println("cron: " + scheduled.cron());
}
}
注意:Java 8+ 支持 instanceof 类型匹配并自动类型转换,比 ann.getClass().equals(Scheduled.class) 更简洁安全。
和 getAnnotations() 的区别要分清
如果你还希望拿到从接口默认方法或超类方法继承来的注解(极少见,因方法注解默认不可继承),那得用 method.getAnnotations() ——但它依然**不会跨类查找**,只是对当前方法做“继承感知”的合并(实际几乎无效果,因为方法级注解默认 @Inherited 不生效)。所以绝大多数场景,getDeclaredAnnotations() 就是你要的“一次性全部拿到”。











