2009-07-16 5 views
2

J'utilise Netbeans (actuellement 6.7) et j'aime vraiment comment je peux générer javadoc à partir de mon code source. Cependant mes tests ont aussi une documentation (documentation précieuse!). Y at-il de toute façon je peux générer des javadocs (idéalement pour les deux en même temps).Comment générer javadoc pour les tests unitaires dans netbeans

Merci!

Répondre

2

Les tests JUnit sont productifs, code Java normal. Ils peuvent contenir des commentaires JavaDoc normaux. Pourquoi ne les traitez-vous pas comme du code Java normal? Il suffit de lancer javadoc sur ce paquet et vous avez terminé.

Vous pouvez générer votre JavaDoc via le menu Générer.

Bonne chance!

+0

Salut, je ne suis pas sûr que vous êtes familier avec NetBeans et c'est le dossier structure du projet. Les tests sont conservés dans un répertoire différent de celui de l'autre code source, donc vous ne pouvez pas lancer javadoc, je dois savoir comment lancer javadoc sur deux répertoires qui contiennent les mêmes paquets et que javadoc les fusionne. En outre, il n'y a pas de menu de construction dans Netbeans. Vous pouvez générer javadoc pour le répertoire src en utilisant le menu Exécuter mais je veux les deux tests src +. Merci! – Mystic

0

Dans Build-impl.xml, il y a une cible nommée "-javadoc-build". Il contient deux sections "ensemble de fichiers". Peut-être qu'il est possible d'ajouter une troisième section ici.

+0

Je ne suis pas sûr que cela fonctionnera. Je vous le ferai savoir quand j'en saurai plus. –

+0

Au lieu de changer build-imp.xml, qui est générée automatiquement modifier build.xml –

0

Ajout de la cible Ant suivante à build.xml le tour est joué pour moi:

<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> 

Il est copié à partir nbproject/build-impl.xml avec trois changements:

  • classpath-"${javac.classpath}:${javac.test.classpath}" agrandir
  • ajouter un élément fileset avec dir="${test.src.dir}" il y a les netbeans normaux "Test Packages"
  • ajouter un fileset élément avec dir="src/try" c'est et le répertoire source supplémentaire que mon projet utilise. (Je ne sais pas comment utiliser une variable comme $ {} test.src.dir de se référer à ce répertoire.)
Questions connexes