JavaDoc: Unterschied zwischen den Versionen
K |
K |
||
| Zeile 3: | Zeile 3: | ||
=Kommentar-Tags= | =Kommentar-Tags= | ||
| − | *@ | + | *@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() ) | ||
| Zeile 13: | Zeile 13: | ||
Ein kleines Beispiel soll die Dokumentation einer [[Methode]] verdeutlichen: | Ein kleines Beispiel soll die Dokumentation einer [[Methode]] verdeutlichen: | ||
<code=java>/** | <code=java>/** | ||
| − | * Gibt das | + | * Gibt ein Image-Objekt zurück, das auf den Bildschirm gezeichnet werden kann. |
| − | * @ | + | * Das URL-Argument muss einen absoluten {@link URL} spezifizieren. |
| − | * @return | + | * Das Argument name spezifiziert dabei den relativen Teil zu der URL. |
| + | * <p> | ||
| + | * 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 | + | public Image getImage(URL url, String name) { |
| − | + | try { | |
| − | + | return getImage(new URL(url, name)); | |
| − | + | } catch (MalformedURLException e) { | |
| − | + | return null; | |
| − | + | } | |
| − | + | }</code=java> | |
| − | |||
| − | }</code=java> | ||
Die Erzeugung der Dokumentation aus den JavaDoc-Kommentaren kann nun mit folgendem Befehl in der Kommandozeile des Betriebssystems ausgelöst werden:<br> | Die Erzeugung der Dokumentation aus den JavaDoc-Kommentaren kann nun mit folgendem Befehl in der Kommandozeile des Betriebssystems ausgelöst werden:<br> | ||
<code>javadoc Klassenname.java</code> | <code>javadoc Klassenname.java</code> | ||
Version vom 14. Oktober 2013, 10:35 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.
- 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
