注释处理器是一些实用程序,它们可以根据 Java 5(JSR-175)注释来生成附加的 Java 代码、其他文件以及问题标记。“注释处理”首选项窗格用于配置应用于项目或工作空间中所有处理器的首选项。“工厂路径”首选项窗格指定了要启用的处理器并允许对各个处理器进行配置。
缺省情况下,注释处理处于关闭状态。要打开注释处理,必须对每个需要使用此功能的项目选中此复选框。仅当需要使用注释处理器来处理项目的代码时,才有必要在该项目中启用注释处理。代码包含注释并不表示需要进行注释处理;例如,@Deprecated
和 @Override
注释通常不要求进行处理。
将在磁盘上相对于所指定目录的位置中生成文件。缺省情况下,此目录名为“.apt_generated”,这导致将在“包资源管理器”视图中过滤掉此目录。生成的文件设置了“派生”位;在从头开始创建项目时,将从所生成源文件目录中除去所有派生文件。建议您仅将处理器生成的文件存放在此目录中;不要将任何手工创建的文件存放在此目录中,也不要将预先存在的目录用作所生成源文件目录。
此处输入的选项将通过 AnnotationProcessorEnvironment 接口供处理器使用。将把某些选项自动提供给处理器。由于自动提供的值将覆盖此对话框中设置的值,因此在此处输入那些选项不起任何作用。此处对自动选项作了描述。有关“输入处理器选项”对话框的主题提供了更多关于处理器选项的信息。