JavaDoc ist ein Software-Dokumentationswerkzeug, welches das automatische Erstellen von HTML-Dokumentationsseiten ermöglicht. Es wurde von Sun Microsystems entwickelt und ist Bestandteil des Java Developer Kits.

JavaDoc parst den Java-Quellcode und generiert daraus automatisch HTML-Dokumente. Dazu sind jedoch spezielle JavaDoc-Kommentare notwendig (beginnend mit /). Die Position dieser Kommentare gibt wie gewohnt an zu was der Kommentar gehört: immer zum nachfolgenden Block. Im Kommentar können spezielle JavaDoc-Tags verwendet werden. ===== JavaDoc-Tags ===== ^ Tag & Parameter ^ Beschreibung ^ Verwendbar in ^ | @author name | Beschreibt den Autor | Klasse, Interface | | @version version | Erzeugt einen Versionseintrag. Darf max. einmal pro Klasse oder Interface verwendet werden! | Klasse, Interface | | @see reference | Erzeugt einen Link auf ein anderes Element der Dokumentation. | Klasse, Interface, Instanzvariable, Methode | | @param name description | Parameterbeschreibung einer Methode | Methode | | @return description | Beschreibung des Rückgabewertes einer Methode | Methode | | @deprecated description | Beschreibt eine veraltete Methode, die nicht mehr verwendet werden sollte. Sollte immer mit der @Deprecated-Annotation verwendet werden! | Methode | | @exception classname description | Beschreibung einer Exception, die von dieser Methode geworfen werden kann. | Methode | | @throws classname description | ::: | ::: | | @since jdk-version | Seit wann die Funktionalität existiert. | Klasse, Interface, Instanzvariable, Method | | {@inheritDoc} | Kopiert die Beschreibung aus der überschriebenen Methode. | Überschreibende Methode | | {@link reference} | Link zu einem anderen Symbol. | Klasse, Interface, Instanzvariable, Methode | | {@linkPlain reference} | Link zu einem anderen Symbol. Der Link wird jedoch als Standardtext angezeigt. | Klasse, Interface, Instanzvariable, Methode | | {@value} | Gibt den Wert eines konstanten Feldes zurück. | Statisches Feld | | {@code} | Formatiert Text buchstabengetreu mit dem Quelltextzeichensatz (entsprechend <code>) und unterdrückt die Interpretierung von beinhalteten HTML oder Javadoc-Tags. | Klasse, Interface, Instanzvariable, Methode | | {@literal}'' | Kennzeichnet buchstabengetreuen Text und unterdrückt die Interpretierung von beinhalteten HTML oder Javadoc-Tags. | Klasse, Interface, Instanzvariable, Methode | ===== Beispiele ===== <code java> / * Ein einfaches Hello-World-Beispiel in Java * mit Javadoc-Kommentaren. Wieviel Text in * so einem Kommentar steht, ist egal. * * @author Martin Züger * @version 0.1 */ public class HelloWorld { /** * Hauptmethode: Wird beim Starten aufgerufen * * @param args Kommandozeilenparameter */ public static void main(String[] args) { System.out.println(„Hello NTB!“); } } </code>