如果缺少方法描述，则显示警告

Question

在我们的代码库中，我看到了很多类似的方法：

/**
     * @param tagID
     * @param startDate
     * @param endDate
     * @param estimated
     * @return
     * @throws ServerException
     */
    List<String> generateMaster(int tagID, Date date)
            throws ServerException, BusinessException;

虽然有一个 javadoc，但缺少方法的描述。因此，javadoc 显然是无用的。在 checkstyle 中，我该怎么做才能对上述情况发出警告。

<property name="allowMissingJavadoc" value="false"/>

这仅检查是否存在 javadoc。它将上述方法标记present为存在 javadoc。但实际上缺少方法声明。

PS：标记eclipse和intellij。我对任何告诉我上面包含的方法数量的解决方案感到满意，例如 javadocs

Answer 1

对于这篇文章来说可能为时已晚 - 但其他任何想要找到答案的人，请为每个元素添加描述，例如

/**
 * @param tagID - ID of the tag
 * @param startDate - Starting Date
 * @param endDate - End date
 * @param estimated <-- this is not the param - should be removed or fix doc
 * @return <-- missing return param and description
 * @throws ServerException -- throws server exception
 */

Answer 2

我们将其用于 checkstyle 中的 javadoc：

<module name="JavadocStyle">
    <property name="severity" value="warning"/
    <property name="checkEmptyJavadoc" value="true"/>
</module>

如你所见checkEmptyJavadoc应该对你有帮助。