在 Eclipse 里使用 Java 6 注解处理器

原文：Using Java 6 processors in Eclipse

http://kerebus.com/2011/02/using-java-6-processors-in-eclipse/

    我没有找到这方面的完整的教程，所以花费两个小时的时间完成了这个，希望他能够节省你的时间。

    JDK 5 加入了 APT（注解处理工具）。它曾是 SDK 的一部分，但它在非官方的 com.sun.* 包里，而且还必须使用“apt”工具来处理源代码。

    JDK6清理了这些API，并将他们集成到 javac 中，所以现在不必再使用独立的apt工具了。

    显然，在把源代码编译成class文件之前根据注解对他们做一些处理，可以用来做一些很有意思的事情。比如代码生成和于 IDE 无关的代码分析；而且你不必直接使用注解。我猜 JPA2 的 meta-model 在他的标准API中就是使用了这个技术实现的。

    我用 Eclipse 写了一个 java 6 注解处理器的例子。所有的内容都可以集成到 maven 中，但我只是集中精力在怎样在 Eclipse 上实现他。

    所以我们要做个注解处理器，可以用它来对工程中的每个类生成一个新的类。另外，我们再让以 T 字母开头的类显示一个警告。对，这很傻。

第一步：新建一个处理器工程

SillyProcessor.java:

@SupportedAnnotationTypes(value= {"*"})
@SupportedSourceVersion(SourceVersion.RELEASE_6)
public class SillyProcessor extends AbstractProcessor {

private Filer filer;
private Messager messager;

@Override
public void init(ProcessingEnvironment env) {
filer = env.getFiler();
messager = env.getMessager();
}

@Override
public boolean process(Set elements, RoundEnvironment env) {

for (Element element : env.getRootElements()) {

if (element.getSimpleName().toString().startsWith("Silly")) {
// 不要循环为已经生成的类生成新的类

continue;
}

if (element.getSimpleName().toString().startsWith("T")) {
messager.printMessage(Kind.WARNING,
"This class name starts with a T!",
element);
}

String sillyClassName = "Silly" + element.getSimpleName();
String sillyClassContent =
"package silly;\n"
+	"public class " + sillyClassName + " {\n"
+	"	public String foobar;\n"
+	"}";

JavaFileObject file = null;

try {
file = filer.createSourceFile(
"silly/" + sillyClassName,
element);
file.openWriter()
.append(sillyClassContent)
.close();
} catch (IOException e) {
e.printStackTrace();
}

}

return true;
}
}

    将这个处理器注册到 Eclipse 上，我建立如下 META-INF 文件：

META-INF/services/javax.annotation.processing.Processor:

com.kerebus.annotation.processor.SillyProcessor

    这里只包含了处理器实现类的类名。我不确定你是否可以在这里列出多个处理器。

    就这样。现在导出一个 jar 文件，并且在你需要用到这个处理器的工程上导入这个文件。

第二步：建立一个使用你的处理器的工程

In the properties for your new project go to Java Compiler -> Annotation Processing
Check the “Enable Project Specific Settings” and make sure “Enable annotation processing” is checked. I also changed the generated source directory to a name which didn’t start with a dot so it wouldn’t be hidden in the package explorer (files or directories which start with a dot are by default filtered away in eclipse).

    在工程的属性中找到  Java Compiler -> Annotation Processing 查看 “Enable Project Specific Settings” 确认 “Enable annotation processing” 被选中。为了不让他在包浏览器中隐藏，我还修改了  generated source directory ，去掉了开始的点（Eclipse 会将文件名以点开始的文件或文件夹过滤掉）。

    然后，转到  Java Compiler -> Annotation Processing -> Factory Path 你可以在这里导入处理器的 jar 文件。不可以使用工程引用。

    点击 “Advanced” 按钮，会显示一个对话框，列出了  META-INF/services/javax.annotation.processing.Processor 文件中的内容。选择它并按OK。

第三步：Build!

    完成了。这是在我的工程里显示的样子：

So we get a warning for the Thing class because its class name start with a “T” and for each class in the project we get corresponding “Silly” classes generated. These are compiled and usable just like any other normal class.

    由于 Thing 类是 T 开头，所以有一个警告，并且每一个工程里的类都生成了一个对应的“Silly”类。这些类的编译和使用与其他普通的类一样。

    欲了解更多请参看 eclipse jdt/apt docs, this bit about creating a code analyzer 或者 offical docs