入门

Eclipse 中的 APT

通过在 Eclipse 中运行为使用 Mirror API 而编写的注释处理器,APT 向 Eclipse 添加了 Java 5 注释处理支持。

当您在 Eclipse 中输入内容时,将触发这些注释处理器。它们直接在编辑器中提供错误和警告以及生成正常的构建工件,就象是从命令行运行 Sun 的 APT 工具一样。

要了解有关此插件的工作方式的更详细信息,您可以访问 JDT-APT 项目 Web 站点

打开注释处理

必须使用“Java->编译器”首选项将项目的编译器配置为使用 Java 5.0 级一致性:

“编译器”首选项页的屏幕快照

接着,必须使用“Java->编译器->注释处理”来启用注释处理:

“注释处理”属性页的屏幕快照

在此对话框中,还可以根据需要指定生成的源目录并提供所需的处理器选项。

注意:Eclipse 将“-Aclasspath”和“-Asourcepath”选项自动传递给所有处理器,因此不必提供这些选项。

添加注释处理器

可以通过“Java->编译器->注释处理->工厂路径”来将注释处理器添加到项目中:

“工厂路径”属性页的屏幕快照

工厂路径和源控制

在与源控制进行交互方面,工厂路径与类路径类似。为了避免硬编码工厂 JAR 的路径,可以通过“添加 Jar...”按钮使用相对于项目的 Jar,也可以通过“添加变量...”按钮来使用类路径变量。

处理器选项和源控制

在某些传递给注释处理器的选项中,可能需要使用路径。同样,通过避免硬编码绝对路径,就能够在源控制中共享配置。

为了实现此功能,我们支持在处理器选项中使用类路径变量。必须通过在变量两端指定 % 来对其进行定界,并且,变量必须是路径的第一段。

因此,如果 F00 是指向 d:/foo 的类路径变量,则将把 %FOO%/bar.txt 解析为 d:/foo/bar.txt。要解析类路径,该类路径变量必须存在;如果该变量不存在,就会将原始字符串添加到环境选项中。但是,bar.txt(在本示例中)不需要存在。

保留的变量 ROOT 具有特殊的含义:它是工作空间根目录并提供项目资源。因此,如果项目名为 quux,则 %ROOT%/quux 将解析为 quux 的绝对路径,%ROOT%/quux/.classpath 将解析为 quux/.classpath 的绝对路径。当使用 ROOT 时,路径的第一段必须确实存在:在本示例中,项目 quux 必须存在,但 .classpath 不需要存在。