3

我对验证 JavaDoc 很感兴趣，我找到了自定义检查的答案：

import com.sun.javadoc.*;

public class CheckingDoclet extends Doclet {

该问题com.sun.javadoc已被删除，将仅在java 9中被替换（这意味着至少使用java 10）

此包中的声明已被包 jdk.javadoc.doclet 中的声明所取代。有关详细信息，请参阅该软件包文档中的迁移指南。

有没有使用 Java 8 的替代品？

编辑

我需要一个新的检查来阻止块标记后的描述，

在 checkstyle 中没有这样的规则，需要创建一个新的检查

在 PMD 中没有这样的规则，可能需要创建一个新的检查

4

1 回答 1

1

我建议使用您的 ide（我的是 eclipse）的 JavaDoc 检查 - 以及CheckStyle和PMD。

对于这三个，您应该进行自己的配置！

在 Eclipse 中，您可以在 Windows/Preferences/Java/Compiler/Javadoc 找到 JavaDocs 的配置

如果您有这些工具无法满足的特殊要求 - 那么忘记 eclipse。您唯一的机会是为 CheckStyle 或 PMD 编写自己的扩展。例如，请参阅编写 CheckStyle 检查。

顺便提一句。也不推荐使用 java internal api's - 请参阅Stackoverflow About Java 8 Doclets。据我所知，这些 api 将在 Java 9/10/11+ 中消失。所以不建议使用它们。

于 2018-10-11T06:46:50.840 回答