Javadoc

Från Wikipedia

Javadoc är ett verktyg som utvecklats av Sun Microsystems för att man enkelt, snabbt och på ett standardiserat sätt ska kunna skapa dokumentation till javaprojekt. Dokumentationen som fås är i HTML-format vilket gör att alla kan läsa den. Det går även att få ut dokumentation i andra format som till exempel PDF.^[1]

[redigera] Hur Javadoc används

Att använda sig av Javadoc är inte svårt. Man ser bara till att kommentera koden på detta sätt:

/**
* Beskrivning av funktion.
*
* @param variabel namn beskrivning av variabel.
*
* @return beskrivning av return värde.
*
* /

Sedan använder man kommandot javadoc följt av filerna man vill dokummentera. Exempel: javadoc Bil.java

[redigera] Ett exempel

/**
 * Den är klassen beskriver en bil.
 */
public class Bil{
    private int hastighet = 0;
    private int maxHastighet = 0;
 
    /**
     * Standardkonstruktor.
     *
     * @param h anger vad max hastigheten för bilen är.
     *
     */
    public Bil(int h){
       //...
    }
 
    /**
     * Ändrar bilens hastighet.
     *
     * @param h bilens nya hastighet.
     *
     */
    public void ändraHastigheten(int h){
        //...
    }
 
    /**
     * Funktionen räknar ut bilens bromssträcka givet den aktuella hastigheten.
     *
     * @return funktionen returneran hur lång bromssträcka bilen har.
     *
     */
    public int beräknaBromsSträcka(){
       //...
    }
 
}