unit-testing - netbeans で単体テスト用の javadoc を生成する方法

Question

私は Netbeans (現在 6.7) を使用しており、ソース コードから javadoc を生成する方法がとても気に入っています。ただし、私のテストにはドキュメントもあります (貴重なドキュメントです!)。とにかく私はJavadocを生成することができますか（理想的には同時に両方のために）。

ありがとう！

Answer 1

JUnit テストは、生産的な通常の Java コードです。通常の JavaDoc コメントが含まれる場合があります。

それらを通常の Java コードのように扱ってみませんか? javadocこのパッケージを実行するだけで完了です。

Build メニューから JavaDoc を生成できます。

幸運を！

Answer 2

次の 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 からコピーされ、次の 3 つの変更があります。

• classpathに展開"${javac.classpath}:${javac.test.classpath}"
• 通常のネットビーンズ「テストパッケージ」filesetがある要素を追加しますdir="${test.src.dir}"
• filesetこれを含む要素を追加dir="src/try"し、プロジェクトが使用する追加のソース ディレクトリを追加します。(このディレクトリを参照するために ${test.src.dir} のような変数を使用する方法がわかりません。)

Answer 3

Build-impl.xml には、「-javadoc-build」という名前のターゲットがあります。2 つの「ファイルセット」セクションが含まれています。おそらく、ここに 3 番目のセクションを追加できます。