如何定义可指定被标注注解@Target的Java元注解？

原写法的问题 #

你尝试的写法中，@Target作为元注解只能在一个注解上标注一次，无法同时指定元注解自身的适用目标和被标注注解的目标，因此这种写法在Java中是不合法的。

正确实现方案 #

原生Java中无法直接让元注解替被标注的注解自动添加@Target，但可以通过自定义元注解+编译期注解处理器的组合来实现类似效果：

1. 定义自定义元注解

先创建一个元注解，自身的@Target设为ANNOTATION_TYPE（只能标注在其他注解上），并添加一个属性用来指定被标注注解的@Target值：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

// 元注解仅可标注在其他注解上
@Target(ElementType.ANNOTATION_TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MetaAnnotation {
    // 指定被标注注解的@Target目标类型
    ElementType[] target() default {};
}

2. 使用元注解标注普通注解

接下来用这个元注解标注你的普通注解，通过target属性指定它的适用目标：

// 指定该注解仅可标注在参数上
@MetaAnnotation(target = ElementType.PARAMETER)
public @interface RegularAnnotation {
}

3. 编写编译期注解处理器（核心逻辑）

要让RegularAnnotation真正拥有指定的@Target，需要编写一个编译期注解处理器，在编译阶段自动为被MetaAnnotation标注的注解添加@Target注解（或做合法性检查）。以下是一个基础示例：

import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.RoundEnvironment;
import javax.annotation.processing.SupportedAnnotationTypes;
import javax.annotation.processing.SupportedSourceVersion;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.AnnotationMirror;
import javax.lang.model.element.Element;
import javax.lang.model.element.ElementKind;
import javax.lang.model.element.TypeElement;
import javax.tools.Diagnostic;
import java.util.Set;

// 指定要处理的元注解全类名
@SupportedAnnotationTypes("com.example.MetaAnnotation")
// 指定支持的Java版本
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class MetaAnnotationProcessor extends AbstractProcessor {

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        for (Element element : roundEnv.getElementsAnnotatedWith(MetaAnnotation.class)) {
            // 仅处理注解类型的元素
            if (element.getKind() != ElementKind.ANNOTATION_TYPE) {
                processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR,
                        "MetaAnnotation仅可标注在注解上", element);
                continue;
            }

            MetaAnnotation metaAnn = element.getAnnotation(MetaAnnotation.class);
            ElementType[] targetTypes = metaAnn.target();

            // 检查被标注注解是否已存在@Target
            boolean hasExistingTarget = false;
            for (AnnotationMirror mirror : element.getAnnotationMirrors()) {
                if (mirror.getAnnotationType().toString().equals("java.lang.annotation.Target")) {
                    hasExistingTarget = true;
                    break;
                }
            }

            if (!hasExistingTarget) {
                // 实际开发中可使用JavaPoet等库生成带@Target的注解类
                processingEnv.getMessager().printMessage(Diagnostic.Kind.NOTE,
                        String.format("注解%s将自动应用@Target(%s)", element.getSimpleName(),
                                String.join(", ", java.util.Arrays.stream(targetTypes).map(ElementType::name).toArray(String[]::new))),
                        element);
            }
        }
        return true;
    }
}

补充说明 #

如果是在Spring生态中，可以借助Spring的@AliasFor注解实现类似的元注解属性传递，但这属于Spring框架的扩展特性，并非原生Java的功能。

内容的提问来源于stack exchange，提问作者KeyboardDrummer