注释处理器是一些实用程序,它们可以根据 Java 5(JSR-175)注释来生成附加的 Java 代码、其他文件以及问题标记。处理器可以基于 Java 5 镜像 API 或 Java 6 注释处理 APIs。“注释处理”首选项窗格用于配置应用于项目或工作空间中所有处理器的首选项。“工厂路径”首选项窗格指定了要启用的处理器并允许对各个处理器进行配置。
缺省情况下,注释处理处于关闭状态。要打开注释处理,必须对每个需要使用此功能的项目选中此复选框。仅当需要使用注释处理器来处理项目的代码时,才有必要在该项目中启用注释处理。代码包含注释并不表示需要进行注释处理,例如,@Deprecated 和 @Override
注释通常不要求进行处理。
如果启用了此选项,那么每当在 Java 编辑器中进行更改以及每当构建项目时,都将运行处理器。通过使处理器能够在编辑器中运行,将允许它们在您输入内容时生成添加错误和警告。例如,处理器可以对错误的注释值添加红色的波形曲线,以指示编译器可能无法发现的语义问题。但是,某些注释处理器的速度比较慢,在编辑器中运行这些处理器会影响编辑器的可用性。在这种情况下,禁用此选项能提高编辑器的性能。每当构建项目时,仍然会运行处理器。此选项不适用于 Java 6 注释处理器,就目前而言,Eclipse 在构建期间只能运行该处理器。
将在磁盘上相对于所指定目录的位置中生成文件。缺省情况下,此目录名为“.apt_generated”。由于以“.”开头,这导致将在“包资源管理器”视图中过滤掉此目录。生成的文件设置了“派生”位;清除项目时,将从所生成的源文件目录中除去所有派生文件。建议您仅将处理器生成的文件存放在此目录中;不要将任何手动创建的文件存放在此目录中,也不要将预先存在的目录用作所生成源文件目录。
此处输入的选项将通过 AnnotationProcessorEnvironment 接口供 Java 5 处理器使用或通过 ProcessingEnvironment 接口供 Java 6 处理器使用。将把某些选项自动提供给 Java 5 处理器。由于自动提供的值将覆盖此对话框中设置的值,因此在此处输入那些选项不起任何作用。此处对自动选项作了描述。有关“输入处理器选项”对话框的主题提供了更多关于处理器选项的信息。