java - 使用 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 任务)。但这是很重的事情。