![Javadoc Javadoc](/modules/owlapps_apps/img/nopic.jpg)
Javadoc est un outil développé par Oracle, permettant de créer une documentation d'API en format HTML depuis les commentaires présents dans un code source en Java.
Conçu à l'origine par Sun MicroSystems (avant son rachat par Oracle), javadoc est le standard industriel pour la documentation des classes Java. La plupart des IDE génèrent automatiquement la javadoc au format HTML.
Lorsqu'ils commentent le code-source, les développeurs Java peuvent signaler qu'un commentaire doit être intégré dans la documentation à l'aide d'une syntaxe spéciale. Un bloc de commentaire Java commençant par /**
deviendra un bloc de commentaire Javadoc qui sera inclus dans la documentation du code source. Les commentaires Javadoc précèdent généralement les déclarations de classes, d'attributs et de méthodes. Il est également possible de décrire un paquetage, en créant un fichier package-info.java
dans le dossier correspondant, dans lequel on inclut un commentaire Javadoc.
Un tag Javadoc commence par une @
(arobase). Le tableau suivant présente certains des tags les plus courants :
Un exemple d'utilisation de Javadoc pour documenter une méthode :
Un exemple d'utilisation de Javadoc pour documenter une classe :
Javadoc fournit également une API pour créer des doclets et des taglets, qui permettent d'analyser la structure d'une application de Java. C'est grâce à cela que JDiff peut produire des rapports de ce qui a changé entre deux versions d'une API.
Toutefois, le concept ne permet de produire la doc de l'API que dans une seule langue.
Owlapps.net - since 2012 - Les chouettes applications du hibou