Java技术问题：如何禁止在类型上使用非顶层注解？

首先明确：Java原生的@Target注解只能限制注解可以标注在哪些Java元素类型（比如类、方法、字段等），无法直接限制注解只能作为其他注解的属性值使用。当前代码中@Foo能直接标注在Bar类上，是因为@Foo未指定@Target（默认允许标注在所有元素类型上），即便指定了@Target，也无法阻止它被直接标注在类上。

要实现@Foo仅能在@FooList内部使用的限制，必须通过编译期注解处理器实现自定义检查，在编译阶段就抛出错误。具体步骤如下：

1. 调整@Foo的@Target（可选但建议） #

虽然不能完全限制，但可以先缩小@Foo的可使用范围，避免不必要的误用。注意：若设置@Target为空数组，@Foo将无法在任何地方使用（包括@FooList内部），因此这里不设置@Target或保留默认即可，核心限制仍靠注解处理器实现。

2. 编写自定义注解处理器 #

创建继承AbstractProcessor的处理器类，编译时扫描所有@Foo的使用场景，若发现@Foo直接标注在类/接口/枚举等元素上（而非作为@FooList的属性值），则抛出编译错误。

示例代码：

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.TypeElement;
import javax.tools.Diagnostic;
import java.util.Set;

@SupportedAnnotationTypes("com.yourpackage.Foo") // 替换为你的Foo注解全类名
@SupportedSourceVersion(SourceVersion.RELEASE_8) // 根据你的Java版本调整
public class FooAnnotationProcessor extends AbstractProcessor {

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        // 遍历所有被@Foo标注的元素
        for (Element element : roundEnv.getElementsAnnotatedWith(Foo.class)) {
            // 检查当前元素是否是类、接口或枚举（直接标注的情况）
            if (element.getKind().isClass() || element.getKind().isInterface() || element.getKind().isEnum()) {
                // 定位该元素上的@Foo注解镜像
                for (AnnotationMirror mirror : element.getAnnotationMirrors()) {
                    if (mirror.getAnnotationType().toString().equals(Foo.class.getName())) {
                        // 抛出编译错误
                        processingEnv.getMessager().printMessage(
                                Diagnostic.Kind.ERROR,
                                "@Foo注解仅能在@FooList内部使用，不可直接标注在类/接口上",
                                element,
                                mirror
                        );
                    }
                }
            }
        }
        return true;
    }
}

3. 注册注解处理器 #

在项目的src/main/resources/META-INF/services目录下创建javax.annotation.processing.Processor文件，文件内容为注解处理器的全类名：

com.yourpackage.FooAnnotationProcessor

4. 编译验证 #

再次编译Bar类时，若直接标注@Foo(name="EFG")，编译器会抛出错误并终止编译；而@FooList内部的@Foo则可正常使用。

补充：若不需要编译期检查，也可在运行时通过反射扫描类上的注解，发现直接标注的@Foo则抛出异常，但这种方式只能在运行时暴露问题，不如编译期检查及时。

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