向导将引导您完成清理选定源代码的过程。左上的描述将显示将被清理的项目及编译单元的数目。通常,我们会将已配置的配置文件应用到编译单元中。但是,可以在应用代码清理之前先进行自定义。如果需要查看某个设置影响代码的结果,这可能十分有帮助。
只要任何 Java 项目、软件包或 Java 文件至少包含一个编译单元,清理向导就可以在其中启动。例如,您可以选择工作区中的所有 Java 项目并启动向导。执行清理将影响工作区中可以用选定配置文件重构的所有编译单元。
默认情况下,有一个用于整个工作区的全局清理配置文件。但是,也可以在项目属性中启用特定于项目的清理。每个项目都可以有自己的清理配置文件。要启用这种清理操作,只需打开项目属性并浏览到 Java Code Style > Clean Up,如下所示:
要预览清理结果,请在清理向导中单击 Next。这时向导将计算代码更改数目。根据选定的编译单元数目,完成此过程可能需要花费一段时间。在下一个页面中,将为您呈现将要应用的更改。
该树列出了将受清理影响的所有编译单元。您可以进入到树中去选择编译单元的不同更改。选择更改将在比较视图中显示初始源代码和经过重构的源代码。在查看了更改后,您可能不希望应用所有更改。在这种情况下,您可以简单地取消选中不必执行的更改。单击 Finish 将执行整个清理操作。
诸如 Convert for loops to enhanced 或 Add missing annotations 之类的某些清理重构操作是与 Java 代码依从性 5.0 或 6.0 绑定的,并且仅当源代码是根据要求的 Java 版本编译的才能应用。清理向导允许您选择那些重构选项,而不论使用的是哪一个 Java 版本。因此如果您想知道没有转换 for 循环或者未能正确注释掉不赞成使用的方法的原因,请在 Preferences > Java > Compiler 下查看工作区或项目的编译器依从级别。
在多次运行清理向导并且配置文件已经正确设置后,您可能不希望每次执行清理操作时都在向导中多次进行单击。在这种情况下,您只需在 Preferences > Java > Code Style > Clean Up 下的配置文件设置页面中禁用向导。
在各种资源上执行代码清理通常会导致很多更改。向导允许您在应用之前预览那些更改。但是,如果数百计文件都受到影响则会使预览不方便,尤其是当您需要在预览过程中查找某个更改时。使用过滤器选项可以缩小预览页面中显示的更改列表。通常,几乎所有文件都会受到源代码格式操作的影响,但是添加缺失的不赞成注释影响的文件却不多。在这种情况下,过滤器将通过过滤其他更改来帮助您找到那些文件。过滤器位于预览页面的右上角。
清理操作不但可以手动执行,而且还可以在执行 Java 文件的保存操作期间执行。要启用此功能,请转到 Window > Preferences > Java > Editor > Save Actions 并选择附加操作。请按前述配置清理操作,然后就会在每次保存 Java 文件时都执行这些清理操作。请注意,执行那些操作有时会加大开销并且降低工作台的速度。同时,如果没有想到清理操作,您可能会在保存刚刚编写的代码后觉得很困惑为什么代码不太一样。

