SDK

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

  • @authorPer classi e interfacce. Obbligatorio… Ripetuto per specificare più autori.
    @author NomeAutore
  • @versionPer classi e interfacce. Obbligatorio.
  • @param – Per metodi e costruttori. Obbligatorio in presenza di parametri. Ripetuto per specificare più parametri.
    @param nomeParametro descrizione
  • @returnPer i metodi. Obbligatorio se non void.
    @return descrizione
  • @exception – Sinonimo @throws
  • @seeRiferimento a un campo o una classe. Ripetuto per specificare più riferimenti.
    @see #nomeCampo
    @see #NomeClasse
  • @since – …
  • @serial – Sinonimi @serialField, @serialData
  • @deprecatedSe 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