Sometimes I put the class name in the comments of methods or class just for referencing. But eclipse does the import automatically and leaves an import statement in the file which causes "unused import" checkstyle errors later. Is there some configuration I can change to avoid eclipse automatically importing when I type the class name in the comments?
可以将文章内容翻译成中文,广告屏蔽插件可能会导致该功能失效(如失效,请关闭广告屏蔽插件后再试):
问题:
回答1:
People don't agree whether this is a bug or not. Javadoc needs the imports to create appropriate links. I'd say checkstyle should provide an option (and Eclipse maybe too) to change the warning.
There are two relevant bug reports:
- eclipse
- checkstyle (now fixed)
Update: The mentioned bug has been fixed in checkstyle. You know have the option to configure the behavior.
回答2:
If you use the fully-qualified class name in the JavaDoc, Eclipse will not add an import, e.g.
/**
* This class is a {@link java.io.File} that blah blah blah
*/
回答3:
The Checkstyle bug has been fixed now. In Checkstyle config, go Imports > Unused Imports > click Open > make sure processJavadoc
is checked.
Now Checkstyle doesn't warn on this anymore.
回答4:
In checkstyle.xml
, change
<module name="UnusedImports"/>
to:
<module name="UnusedImports">
<property name="processJavadoc" value="true"/>
</module>
This requires version 6.0 of Checkstyle.
Source: https://github.com/jboss/jboss-parent-pom/issues/23