Il software development kit (SDK) ufficiale è denominato Java Development Kit (JDK).
Contiene gli strumenti più comuni utilizzati per creare applicazioni Java:
- appletviewer – visualizzatore delle applet
- jar – …
- java – esecutore
- javac – compilatore
- javadoc – crea la documentazione delle classi
- javap – disassemblatore
- jdb – …
appletviewer
Con appletviewer è possibile lanciare le applet contenute in un documento senza usare un browser
appletviewer [opzioni] indirizzi ...
Le opzioni da linea di comando più comuni sono
-classic | Utilizza la JVM versione 1.2 di Java 2 SDK |
---|---|
-debug | Lancia l’appletviewer all’interno del debugger jdb |
javac
L’ordine degli argomenti è libero e i file da compilare possono essere più di uno
javac [options] [sourcefiles] [@argfiles]
Con
options | opzioni da linea di comando |
---|---|
sourcefiles | uno o più file che si vuole siano compilati |
@argfiles | uno o più file, preceduti da @, che contengono un elenco di file sorgente e/o di opzioni (tranne -J) |
Le opzioni da linea di comando più comuni sono
-classpath … | Specifica il percorso per le classi sovrascrivendo la variabile CLASSPATH |
---|---|
-d … | Specifica la cartella di destinazione per i file .class |
-deprecation | Mostra una descrizione dell’uso o sovrascrittura di una classe o un membro deprecato |
-g | Genera tutte le informazioni di debugging, comprese le variabili locali |
-g:none | Non genera alcuna informazione di debugging |
-nowarn | Disabilita i messaggi di warning |
-sourcepath … | Specifica il percorso dove cercare il codice sorgente per le defnizioni di interfacce e di classi Come per classpath, i diversi percorsi sono separati da punto e virgola (;) Possono essere cartelle, archivi JAR e archivi ZIP |
-verbose | output chiacchierone |
javadoc
A partire dai file sorgente di classi, o pacchetti, produce automaticamente la documentazione in formato HTML.
Si tratta del formato ufficiale delle API di Java!
Estrae automaticamente le intestazioni delle classi, interfacce, costruttori, metodi e campi e in più aggiunge le informazioni contenute nei commenti.
javadoc [ opzioni ] [ nomiPacchetti ] [ nomiFile ] [ -subpackages pkg1:pkg2:... ] [ @fileArgomenti ]
Opzioni
…
Formato dei commenti
I commenti devono avere un formato standard perché possano essere estratte le informazioni da formattare e devono precedere la risorsa corrispondente.
Commento breve
/** Commento */
oppure
/**
Commento 1
Commento 2
...
Tag 1
Tag 2
...
*/
oppure
/**
* Commento 1
* Commento 2
* ...
* Tag 1
* Tag 2
* ...
*/
Tag
Nell’ordine consigliato ufficialmente
- @author – Per classi e interfacce. Obbligatorio… Ripetuto per specificare più autori.
@author NomeAutore - @version – Per classi e interfacce. Obbligatorio.
- @param – Per metodi e costruttori. Obbligatorio in presenza di parametri. Ripetuto per specificare più parametri.
@param nomeParametro descrizione - @return – Per i metodi. Obbligatorio se non void.
@return descrizione - @exception – Sinonimo @throws
- @see – Riferimento a un campo o una classe. Ripetuto per specificare più riferimenti.
@see #nomeCampo
@see #NomeClasse - @since – …
- @serial – Sinonimi @serialField, @serialData
- @deprecated – Se esiste una nuova versione per il metodo.
javap
Il comando javap disassembla un file .class
javap [options] class ...
Opzioni
-help | Visualizza il messaggio di help |
---|---|
-c | Visualizza il codice disassemblato, cioè le istruzioni in bytecode, per ognuno dei metodi della classe |
-verbose | Visualizza maggiori informazioni sullo stack e sulle risorse dei metodi |