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

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
 */