java - 如何使用 Java 生成 javadoc？

Question

我正在编写一个 Java 应用程序，它可以让我编译一个 Java 项目完全基于它的文件结构，这样我就可以在没有 IDE 的情况下编写代码和编译。我目前遇到的问题是我想在编译时自动生成 javadoc，虽然 Java 6 提供了一个 JavaCompiler 对象来处理，但我找不到使用 javadoc 命令的方法。

如何使用 Java 代码为我的项目生成 javadoc html？

Answer 1

以防万一你不知道Apache Ant和 Apache Maven是为了实现与您正在编写的目标类似的目标而存在的工具(在没有 IDE 的情况下编译)。

它们都内置了对生成 javadoc 的支持。 Ant 语法如下所示:

<!-- publish javadoc -->
<target name="javadoc" description="Creates javadoc for IMP.">
      <delete dir="${web-javadoc}"/>
      <javadoc sourcepath="${source}"
               defaultexcludes="no"
               destdir="${web-javadoc}"
               author="true"
               version="true"
               use="true"
               windowtitle="IMP: Integrated Mechanisms Program"
               overview="${source}/overview.html"
               classpathref="debug.classpath"
               stylesheetfile="${javadoc-theme}/stylesheet.css"
       />

       <copy file="${javadoc-theme}/javadoc.jpg" tofile="${web-javadoc}/javadoc.jpg"/>
</target>

如果你真的想自己生成它，你想使用 Doclet API

import com.sun.javadoc.*;

public class ListClass {
    public static boolean start(RootDoc root) {
        ClassDoc[] classes = root.classes();
        for (int i = 0; i < classes.length; ++i) {
            System.out.println(classes[i]);
        }
        return true;
    }
}