创建自定义 AbstractProcessor 并与 Eclipse 集成

Question

我正在尝试创建一个新的注释，用它进行一些运行时接线，但是，由于多种原因，我想在编译时验证我的接线是否会通过一些基本检查成功。

假设我创建一个新注释：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomAnnotation{
}

现在我想在编译时进行某种验证，例如检查 CustomAnnotation 注释的字段是否属于特定类型：PspecialType。我正在使用 Java 6，因此我创建了一个 AbstractProcessor：

@SupportedAnnotationTypes("com.example.CustomAnnotation")
public class CompileTimeAnnotationProcessor extends AbstractProcessor {

    @Override
    public boolean process(Set<? extends TypeElement> annotations, 
                           RoundEnvironment roundEnv) {
        Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(CustomAnnotation.class);
        for(Element e : elements){
            if(!e.getClass().equals(ParticularType.class)){
                processingEnv.getMessager().printMessage(Kind.ERROR,
                     "@CustomAnnotation annotated fields must be of type ParticularType");
            }
        }
        return true;
    }

}

然后，根据我找到的一些说明，我创建了一个文件夹 META-INF/services 并创建了一个文件javax.annotation.processing.Processor 内容：

 com.example.CompileTimeAnnotationProcessor

然后，我将项目导出为 jar。

在另一个项目中，我构建了一个简单的测试类：

public class TestClass {
    @CustomAnnotation
    private String bar; // not `ParticularType`
}

我按如下方式配置了 Eclipse 项目属性：

• 设置 Java 编译器 ->注解处理：“启用注解处理”和“在编辑器中启用处理”
• 设置Java编译器->注释处理->包含我导出的 jar 的工厂路径，并在高级下检查我的完全合格的类是否显示。

我单击“应用”，Eclipse 提示重建项目，我单击“确定”——但没有抛出任何错误，尽管有注释处理器。

我哪里做错了？

---

我使用 javac 运行它作为

javac -classpath "..\bin;path\to\tools.jar" -processorpath ..\bin -processor com.example.CompileTimeAnnotationProcessor com\test\TestClass.java

输出

@CustomAnnotation 注解字段的类型必须为 PspecialType

Answer 1

要在编辑器中显示错误，需要在 printMessage 函数中标记导致错误的 Element。对于上面的示例，这意味着编译时检查应使用：

processingEnv.getMessager().printMessage(Kind.ERROR,
    "@CustomAnnotation annotated fields must be of type ParticularType",
    e); // note we explicitly pass the element "e" as the location of the error