当前位置：首页 > news >正文

JAVA注解处理

news 2025/8/15 6:05:15

元注解

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<A>)`

这个方法完全支持@AliasFor。例如@PostMapping中嵌套了@RequestMapping注解，并且各属性依赖于它的属性。通过以下代码可以获取@PostMapping的path属性，且path和value的值互通。

示例：

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

参考来源：org.springframework.web.servlet.mvc.method.annotation.MvcUriComponentsBuilder#getClassMapping

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];
}

`AnnotationUtils`

`getAnnotation(Annotation, Class<A>)`

对于元注解的支持没有AnnotatedElementUtils强大，不支持元注解@AliasFor在嵌套注解中属性的关联，仅能获取当前注解的@AliasFor关联属性。以下代码可以获取@RequestMapping的path属性，且path和value的值互通。但不能通过获取@RequestMapping来获取@PostMapping中配置的path属性值。

示例：

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