Générer Javadoc pour les interfaces seulement en utilisant Ant?

Question

J'utilise Apache Ant pour générer Javadoc pour mon programme qui a de nombreux projets (ou modules). Cependant, je veux générer Javadoc pour les interfaces seulement, et je ne sais pas comment vérifier si un fichier est une classe ou une interface dans Ant. Quelqu'un m'a suggéré que je devrais utiliser <fileset> et spécifier une liste de fichiers à exclure ou à inclure. Cependant, il y a des centaines de fichiers dans mon programme et spécifier une liste de fichiers de classe à exclure est impossible.

Est-ce que quelqu'un a des idées, s'il vous plaît?

Answer 1

Je ne crois pas que ce soit possible à moins que vous écrivez votre propre ant-tâche, (ce qui ne serait pas que réellement réellement) et référence cela dans votre script Ant.

Une autre méthode (beaucoup plus laide) serait de générer le fichier java-doc complet et de supprimer les fichiers non-interface. Celles-ci pourraient par exemple être identifiés en regardant le allclasses-frame.html:

<A HREF="javax/swing/text/ComponentView.html" title="class in javax.swing.text" target="classFrame">ComponentView</A> 
<A HREF="java/awt/Composite.html" title="interface in java.awt" target="classFrame"><I>Composite</I></A> 

où vous avez à la fois le type (dans le titre = ...) et le fichier (href = ...) disponible.

Answer 2

Avez-vous envisagé d'écrire votre propre document? Au lieu d'essayer d'obtenir des ant pour faire le travail, créez un doclet qui sait comment éliminer toutes les non-interfaces. Ensuite, utiliser la tâche javadoc dans ant est simple.

Espérons que ça aide.