JavaDoc: Unterschied zwischen den Versionen

Aus Byte-Welt Wiki
Zur Navigation springenZur Suche springen
K (Kommentar-Tags)
K (Kommentar-Tags)
Zeile 3: Zeile 3:
 
=Kommentar-Tags=
 
=Kommentar-Tags=
  
*@param - dokumentiert ein an eine Methode übergebenes Argument.
+
*'''@param''' - dokumentiert ein an eine Methode übergebenes Argument.
*@return - dokumentier den Rückgabewert einer Methode.
+
*'''@return''' - dokumentier den Rückgabewert einer Methode.
*@see - dient zum Verweisen (Link) auf einen weiterführenden Text in einer (anderen) Dokumentation (Bsp.: @see javax.swing.JButton#setText() )
+
*'''@see''' - dient zum Verweisen (Link) auf einen weiterführenden Text in einer (anderen) Dokumentation (Bsp.: @see javax.swing.JButton#setText() )
*@since - dient zur Hervorhebung der Einführung in den Code, also seit wann (z.B. Versionsnummer) ein bestimmtes Feature verfügbar ist.  
+
*'''@since''' - dient zur Hervorhebung der Einführung in den Code, also seit wann (z.B. Versionsnummer) ein bestimmtes Feature verfügbar ist.  
*@deprecated - dient zum Kennzeichnen veralteter Methode, die nicht mehr eingesetzt werden sollten. Siehe auch: [[deprecated]].
+
*'''@deprecated''' - dient zum Kennzeichnen veralteter Methode, die nicht mehr eingesetzt werden sollten. Siehe auch: [[deprecated]].
*@throws - dient zur Angabe von checked (geprüften) Exceptions.
+
*'''@throws''' - dient zur Angabe von checked (geprüften) Exceptions.
*<code><code></code> - dient zum Formatieren von Code-Beispielen innerhalb der JavaDoc. (Bsp.: <code><code>BeispielCode bc = new BeispielCode();</code></code> )
+
*'''<code><code></code>''' - dient zum Formatieren von Code-Beispielen innerhalb der JavaDoc. (Bsp.: <code><code>BeispielCode bc = new BeispielCode();</code></code> )
  
 
=Beispiel=
 
=Beispiel=

Version vom 14. Oktober 2013, 11:05 Uhr

JavaDoc ist ein kleines Werkzeug aus dem JDK, mit dem sich aus speziellen Kommentaren im Quellcode eines Java-Programmes Dokumentationstexte im HTML-Format generieren lassen.

Kommentar-Tags

  • @param - dokumentiert ein an eine Methode übergebenes Argument.
  • @return - dokumentier den Rückgabewert einer Methode.
  • @see - dient zum Verweisen (Link) auf einen weiterführenden Text in einer (anderen) Dokumentation (Bsp.: @see javax.swing.JButton#setText() )
  • @since - dient zur Hervorhebung der Einführung in den Code, also seit wann (z.B. Versionsnummer) ein bestimmtes Feature verfügbar ist.
  • @deprecated - dient zum Kennzeichnen veralteter Methode, die nicht mehr eingesetzt werden sollten. Siehe auch: deprecated.
  • @throws - dient zur Angabe von checked (geprüften) Exceptions.
  • - dient zum Formatieren von Code-Beispielen innerhalb der JavaDoc. (Bsp.: BeispielCode bc = new BeispielCode(); )

Beispiel

Ein kleines Beispiel soll die Dokumentation einer Methode verdeutlichen: <code=java>/**

* Gibt ein Image-Objekt zurück, das auf den Bildschirm gezeichnet werden kann. 
* Das URL-Argument muss einen absoluten {@link URL} spezifizieren. 
* Das Argument name spezifiziert dabei den relativen Teil zu der URL. 

*

* Die Methode kehrt sofort zurück, unabhängig davon, ob das Image existiert. * Wenn dieses Applet das Zeichnen auf den Bildschirm anstößt, werden die * Daten geladen. * * @param url eine absolute URL, die den Basis-Speicherort des Bildes angibt. * @param name der Speicherort des Bildes, relativ zur URL * @return das Bild an der spezifizierten URL * @see Image */ public Image getImage(URL url, String name) { try { return getImage(new URL(url, name)); } catch (MalformedURLException e) { return null; } }</code=java> Die Erzeugung der Dokumentation aus den JavaDoc-Kommentaren kann nun mit folgendem Befehl in der Kommandozeile des Betriebssystems ausgelöst werden:
javadoc Klassenname.java