annotatedelement接口是java反射读取注解的统一入口，提供isannotationpresent（判断存在）、getannotation（获取单个）、getannotations（获取全部）、getannotationsbytype（按类型获取，支持重复与继承）四类核心方法。
Java中AnnotatedElement接口是反射读取注解的统一入口，所有可被注解的程序元素（如Class、Method、Field、Constructor等）都实现了它。它的核心方法围绕“是否存在”“获取单个”“获取全部”“按类型获取”四类需求设计，逻辑清晰且分工明确。
判断注解是否存在：isAnnotationPresent
该方法用于快速检查某类型注解是否存在于当前元素上，返回boolean，不触发注解实例化，性能开销最小。底层实际调用getAnnotation(annotationClass) != null，但语义更明确，适合做条件分支前置判断。
- 适用于运行时轻量级校验，比如权限控制前先确认是否有
@RequireRole - 对
@Inherited注解也生效，会检查继承链上的直接或间接存在
获取指定类型的注解实例：getAnnotation
返回目标类型的注解对象（如@MethodInfo），若不存在则返回null。这是最常用的方法，拿到注解实例后即可调用其属性方法（如info.author()）提取元数据。
- 只返回一个实例，即使该注解被重复声明（除非使用
@Repeatable） - 支持
@Inherited，子类可继承父类的类级别注解 - 要求注解的
@Retention(RetentionPolicy.RUNTIME)，否则运行时不可见
获取所有注解数组：getAnnotations
返回当前元素上所有@Retention(RUNTIME)注解的数组，包含直接声明的和通过继承获得的注解。适合批量扫描、通用处理场景。
- 结果包含继承来的注解（例如父类的
@Entity被子类继承） - 不区分注解是否可重复；若需处理重复注解，应改用
getAnnotationsByType - 返回数组可被修改，不影响其他调用者
按类型获取（含重复与继承支持）：getAnnotationsByType
这是功能最全面的方法，专门解决@Repeatable注解和继承注解的聚合问题。它返回指定类型的全部注解实例，包括直接存在、间接存在（如容器注解内嵌）、以及继承而来的注解。
- 当注解标注了
@Repeatable(Container.class)时，必须用此方法才能拿到全部重复项 - 自动合并同类型注解，无论来自本体、容器或父类
- 比
getAnnotation更重，但语义更准确，适合框架级通用解析
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
