使用 ant 仅为给定类（java 文件）的依赖类创建 javadoc

Question

我想使用 ant 从 java 源文件和该文件的依赖类创建 javadoc。这些位于 java 项目中，但我不需要所有 java 文件中的 javadoc。 有没有办法像 javac 一样创建 javadoc

javac includes="package/Java_source.java" destdir="dir/classes"

来编译源文件和依赖类？如果没有的话还有别的办法吗？

谢谢，塔马斯

Answer 1

好吧，您可以添加文件集和/或包集参数：

带有文件集的示例：

<javadoc
    destdir="docs/api"
    author="true"
    version="true"
    use="true"
    windowtitle="Test API">

    <fileset dir="src">
      <include name="foo/bar/BaseClass.java"/>
      <include name="foo/bar/baz/DependentClassA.java"/>
      <include name="foo/bar/phleem/DependentClassB.java"/>
    </filset>

</javadoc>

但恐怕您必须自己找出依赖的类。

参考：

• Ant javadoc Task

---

没有办法在不开始工作的情况下找出什么是“依赖类”。我唯一能想到的是一个残酷的黑客：

在编译的类上，使用字节码分析工具，例如 ASM 并检查代码库中的所有类对给定类的使用情况（源代码分析是不够的，因为可能存在通配符导入和同包使用）。从使用的类列表中，构建源文件列表，并将其传递给 Javadoc 任务（可能最好创建一个执行所有这些操作的 Ant 任务）。但这是很重的东西。