声纳中的Javadoc8问题

时间:2017-08-24 13:13:24

标签: sonarqube javadoc

我们将SonarQube版本5.6.5与SonarJava插件版本4.4.0.8066一起使用,我想知道为什么Sonar无法识别直接执行javadoc时生成的标准javadoc警告,例如:

warning - Missing closing '}' character for inline tag: "{@link #foo >0)."
warning - @created is an unknown tag.
warning - @return tag has no arguments.
warning - @return tag cannot be used in method with void return type.
warning - @param argument "blah" is not a parameter name.
warning - Tag @see: reference not found: 
warning - Tag @link:illegal character: "62" in "List<Test>"

这些是非常明显的警告,所以我真的很想知道SonarQube是如何分析javadoc的。很明显他们不使用javadoc工具本身。

在我的研究中我发现“UndocumentedAPI”规则中存在一些错误修正,例如在版本4.11中: enter image description here

我可以尝试使用最新的SonarJava安装最新的Sonarqube,以检查事情是否有所改善,但我现在更愿意省力。

有人可以告诉我哪些版本涵盖了所有标准的javadoc8警告吗?

非常感谢

1 个答案:

答案 0 :(得分:1)

SonarJava不会执行这些JavaDoc正确性检查。

如果您发现它们对您的流程至关重要,那么您可能需要为此编写自定义规则。 A tutorial exists让你开始。