3

我正在使用 Netbeans（目前是 6.7），我真的很喜欢如何从我的源代码生成 javadoc。但是我的测试也有文档（有价值的文档！）。无论如何我可以生成javadocs（理想情况下同时用于两者）。

谢谢！

4

3 回答 3

2

JUnit 测试是高效的、普通的 Java 代码。它们可能包含普通的 JavaDoc 注释。

为什么不把它们当作普通的 Java 代码对待呢？只需运行javadoc这个包，你就完成了。

您可以通过 Build Menu 生成 JavaDoc。

祝你好运！

于 2009-07-17T06:17:36.830 回答
1

将以下 Ant 目标添加到 build.xml 对我有用：

    <target depends="init" name="-javadoc-build">
    <javadoc additionalparam="${javadoc.additionalparam}" author="${javadoc.author}" charset="UTF-8" destdir="${dist.javadoc.dir}" docencoding="UTF-8" encoding="${javadoc.encoding.used}" failonerror="true" noindex="${javadoc.noindex}" nonavbar="${javadoc.nonavbar}" notree="${javadoc.notree}" private="${javadoc.private}" source="${javac.source}" splitindex="${javadoc.splitindex}" use="${javadoc.use}" useexternalfile="true" version="${javadoc.version}" windowtitle="${javadoc.windowtitle}">
        <classpath>
            <path path="${javac.classpath}:${javac.test.classpath}"/>
        </classpath>
        <fileset dir="${test.src.dir}" excludes="*.java,${excludes}" includes="${includes}">
            <filename name="**/*.java"/>
        </fileset>
        <fileset dir="src/try" excludes="*.java,${excludes}" includes="${includes}">
            <filename name="**/*.java"/>
        </fileset>
        <fileset dir="${src.dir}" excludes="*.java,${excludes}" includes="${includes}">
            <filename name="**/*.java"/>
        </fileset>
        <fileset dir="${build.generated.sources.dir}" erroronmissingdir="false">
            <include name="**/*.java"/>
            <exclude name="*.java"/>
        </fileset>
    </javadoc>
    <copy todir="${dist.javadoc.dir}">
        <fileset dir="${src.dir}" excludes="${excludes}" includes="${includes}">
            <filename name="**/doc-files/**"/>
        </fileset>
        <fileset dir="${build.generated.sources.dir}" erroronmissingdir="false">
            <include name="**/doc-files/**"/>
        </fileset>
    </copy>
</target>

它是从 nbproject/build-impl.xml 复制而来的，有三处更改：

  • 扩大classpath到"${javac.classpath}:${javac.test.classpath}"
  • 添加一个带有正常netbeans “测试包”fileset的元素dir="${test.src.dir}"
  • 添加一个fileset元素，dir="src/try"这是我的项目使用的额外源目录。（我不知道如何使用像 ${test.src.dir} 这样的变量来引用这个目录。）
于 2012-06-09T21:09:59.480 回答
0

在 Build-impl.xml 中有一个名为“-javadoc-build”的目标。它包含两个“文件集”部分。也许可以在这里添加第三部分。

于 2012-06-09T12:58:28.427 回答