通过在 Eclipse 中运行为使用 Mirror API 而编写的注释处理器,APT 向 Eclipse 添加了 Java 5 注释处理支持。
当您在 Eclipse 中输入内容时,将触发这些注释处理器。它们直接在编辑器中提供错误和警告以及生成正常的构建工件,就象是从命令行运行 Sun 的 APT 工具一样。
要了解有关此插件的工作方式的更详细信息,您可以访问 JDT-APT 项目 Web 站点。
接着,必须使用“Java->编译器->注释处理”来启用注释处理:
在此对话框中,还可以根据需要指定生成的源目录并提供所需的处理器选项。
注意:Eclipse 将“-Aclasspath”和“-Asourcepath”选项自动传递给所有处理器,因此不必提供这些选项。
在某些传递给注释处理器的选项中,可能需要使用路径。同样,通过避免硬编码绝对路径,就能够在源控制中共享配置。
为了实现此功能,我们支持在处理器选项中使用类路径变量。必须通过在变量两端指定 % 来对其进行定界,并且,变量必须是路径的第一段。
因此,如果 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 不需要存在。