如何在Eclipse中调试Doclet？

Question

我正在创建一个定制的doclet，我想用Javadoc插件在我的Maven构建中运行它，但现在我想在Eclipse中测试/调试Doclet。我该怎么做呢？

我必须以编程方式调用javadoc吗？又是如何做到的？

Answer 1

您可以简单地在doclet中创建一个main方法并调用(例如，请参阅完整的cmdling参考)：

public class MyDoclet extends Doclet {

    public static void main(String[] args) {
        com.sun.tools.javadoc.Main.execute("-doclet " + MyDoclet.class.getName());
    }
}

这也适用于调试器。

您可能还需要添加包含解析实际代码所需的所有jar依赖项的-classpath参数。

Answer 2

如果您运行的是JDK v1.8，则可能需要使用以下代码片段：

Main.execute(docletFqcn.getClass().getClassLoader(), "-doclet", docletFqcn, javaSourceFilePath);

其中docletFqcn是Doclet类的完全限定类名，javaSourceFilePath是要处理的Java文件的位置。

Answer 3

我收到错误消息@Jan answer

Error:(13, 35) java: reference to execute is ambiguous
  both method execute(java.lang.String...) in com.sun.tools.javadoc.Main and method execute(java.lang.String,java.lang.String...) in com.sun.tools.javadoc.Main match

在更改这些代码之后，它工作得很好

com.sun.tools.javadoc.Main.execute(new String[]{
                "-doclet", CustomDoclet.class.getName(),
                "path/to/src/XXX.java"
        });