如何通过反射获取类上的注解信息？

题目

如何通过反射获取类上的注解信息？

信息

• 类型：问答
• 难度：⭐

考点

反射,注解,Class类方法

快速回答

通过反射获取类上注解的步骤如下：

1. 使用Class.forName()或对象.getClass()获取Class对象
2. 调用Class对象的getAnnotation()方法获取特定注解
3. 调用isAnnotationPresent()检查注解是否存在
4. 通过注解对象获取注解属性值

原理说明

Java反射机制允许在运行时检查类、方法、字段等结构信息。注解（Annotation）是附加在代码上的元数据，通过反射API可以读取这些元数据信息。核心类：

• java.lang.Class：类的元数据入口
• java.lang.annotation.Annotation：所有注解的父接口

代码示例

定义注解：

@Retention(RetentionPolicy.RUNTIME)  // 必须设置为RUNTIME
@Target(ElementType.TYPE)          // 作用于类
public @interface AuthorInfo {
    String author();
    String date();
}

使用注解：

@AuthorInfo(author = "张三", date = "2023-10-01")
public class MyService {
    // 类实现...
}

反射获取注解：

public class AnnotationDemo {
    public static void main(String[] args) throws Exception {
        // 获取Class对象
        Class<?> clazz = Class.forName("com.example.MyService");

        // 方法1：检查注解是否存在
        if (clazz.isAnnotationPresent(AuthorInfo.class)) {
            // 方法2：获取注解实例
            AuthorInfo annotation = clazz.getAnnotation(AuthorInfo.class);
            System.out.println("作者: " + annotation.author());
            System.out.println("日期: " + annotation.date());
        }
    }
}

最佳实践

• 注解保留策略：必须使用@Retention(RetentionPolicy.RUNTIME)，否则运行时无法获取
• 空值处理：使用isAnnotationPresent()先检查注解是否存在
• 性能考虑：反射操作较慢，避免在频繁执行的代码中使用

常见错误

• 忘记RetentionPolicy.RUNTIME：导致运行时无法获取注解
• 混淆getAnnotation()和getAnnotations()：前者获取特定注解，后者返回所有注解数组
• 类加载问题：使用Class.forName()时要写完整类名（包含包路径）

扩展知识

• 其他元素注解：相同方法可获取方法(Method)、字段(Field)上的注解
• 注解继承：默认不继承父类注解，可通过@Inherited元注解实现
• 注解属性类型：支持基本类型、String、Class、枚举、注解及上述类型的数组