元注解

JDK元注解

@Target

指定注解可以应用的目标（如类、方法、字段等）。

常用取值（ElementType 枚举）：

• TYPE：类、接口、枚举
• FIELD：字段
• METHOD：方法
• PARAMETER：方法参数
• CONSTRUCTOR：构造函数
• ANNOTATION_TYPE：注解（用于定义元注解）

示例：

@Target(ElementType.METHOD) // 只能用在方法上
public @interface MyAnnotation {}

@Retention

指定注解的生命周期（源码、编译期、运行时）。
常用取值（RetentionPolicy 枚举）：

• SOURCE：仅源码保留（如 @Override，编译后丢弃）
• CLASS：编译期保留（默认，但运行时不可见）
• RUNTIME：运行时保留（可通过反射读取）

示例：

@Retention(RetentionPolicy.RUNTIME) // 运行时可通过反射获取
public @interface MyAnnotation {}

@Documented

标记注解是否包含在 JavaDoc 中。
示例：

@Documented // 生成的 JavaDoc 会显示此注解
public @interface MyAnnotation {}

@Inherited

允许子类继承父类的注解（仅对 @Target(ElementType.TYPE) 有效）。
示例：

@Inherited // 子类会继承父类的此注解
public @interface MyAnnotation {}

@MyAnnotation
class Parent {}

class Child extends Parent {} // Child 也拥有 @MyAnnotation

@Repeatable（Java 8+）

允许同一注解在同一个位置重复使用。
示例：

@Repeatable(MyAnnotations.class) // 可重复使用
public @interface MyAnnotation {
    String value();
}

@MyAnnotation("A")
@MyAnnotation("B") // 合法
class MyClass {}

@Native（Java 8+）

用于指示某个字段可能被本地代码（如 JNI）引用。

用法：

• 不强制约束：@Native 仅是一个标记，不改变字段的访问权限或行为。
• 非运行时注解：编译后会被丢弃，无法通过反射获取。
• 仅限字段：不能用于方法、类或其他目标。

示例：

public class NativeExample {
    @Native 
    public static final int BUFFER_SIZE = 1024; // 可能被本地代码使用

    static {
        System.loadLibrary("nativeLib"); // 加载本地库
    }

    public native void nativeMethod(); // 本地方法声明
}

Spring 扩展的元注解

@AliasFor

定义注解属性的别名（如 @RequestMapping.path 和 @RequestMapping.value）。
示例：

public @interface MyAnnotation {
    @AliasFor("path") // value 和 path 是别名
    String value() default "";
    
    @AliasFor("value")
    String path() default "";
}

@Component（间接元注解）

标记一个类为 Spring 组件（@Service、@Controller 等均元标注了 @Component）。
示例：

@Component // @Service 元标注了 @Component
public @interface Service {}

@Indexed（Spring 5+）

加速类路径扫描，提升启动性能。
示例：

@Indexed // 标记为可索引的组件
@Component
public class MyComponent {}

Spring工具类

AnnotatedElementUtils

findMergedAnnotation(AnnotatedElement, Class)

RequestMapping requestMapping = AnnotatedElementUtils.findMergedAnnotation(clazz, RequestMapping.class);
System.out.println(Arrays.toString(requestMapping.path()));

private static String getClassMapping(Class<?> controllerType) {
    Assert.notNull(controllerType, "'controllerType' must not be null");
    RequestMapping mapping = AnnotatedElementUtils.findMergedAnnotation(controllerType, RequestMapping.class);
    if (mapping == null) {
        return "/";
    }
    String[] paths = mapping.path();
    if (ObjectUtils.isEmpty(paths) || !StringUtils.hasLength(paths[0])) {
        return "/";
    }
    if (paths.length > 1 && logger.isTraceEnabled()) {
        logger.trace("Using first of multiple paths on " + controllerType.getName());
    }
    return paths[0];
}

getAnnotation(Annotation, Class)

RequestMapping requestMapping = AnnotationUtils.getAnnotation(clazz, RequestMapping.class);
System.out.println(Arrays.toString(requestMapping.path()));

findAnnotation(AnnotatedElement, Class)