Alcuni suggerimenti per la Compilazione dei Sorgenti Java

Una volta decompresso il file po-0405.tgz si ottiene un albero di directory della seguente forma:

progetto
    src
        scacchi
            main
            prova
            soluzione
    doc
        scacchi
            main
            prova
            soluzione        
    classes
        scacchi
            main
            prova
            soluzione

che rispecchia l'organizzazione in package del progetto. In particolare, le sottodirectory src contiene i sorgenti delle classi. La sottodirectory doc la documentazione e classes le classi compilate.

Come compilare

La cosa più semplice da fare per compilare i sorgenti è mettersi nella directory src e digitare

javac -d ../classes <files-java>

dove <files-java> è un elenco di file sorgenti da compilare. Ad esempio,

javac -d ../classes scacchi/main/*.java

compila tutti i sorgenti in scacchi/main. L'opzione -d ../classes del comando javac garantische che le classi compilate vengono copiate nell'opportuna sottodirectory di classes invece che nella directory dei sorgenti. Questa opzione si può omettere ma in questo caso i file delle classi compilate saranno create nelle stesse directory dei sorgenti.

Se si vuole compilare posizionandosi in una qualsiasi directory invece che in src, si può usare l'opzione -sourcepath <source-dir> in questo modo i sorgenti saranno cercati a partire dalla directory specificata. Nel nostro caso <source-dir> dovrà essere un riferimento alla directory src. Ad sempio, se ci trova dentro la sottodirecotry src/scacchi/main per compilare ii sorgenti in questa dir si può eseguire il comando

javac -sorcepath ../.. -d ../../../classes *.java

Come eseguire i programmi

L'archivio disponibile sulla pagina del progetto contiene nel package scacchi.prova un programma di prova Prova.java che legge dei comandi secondo la sintassi descritta nelle specifiche del progetto e fornisce delle risposte costanti prefissate invocando una versione di prova di PartitaScacchi contenuta nel package scacchi.prova. Supponendo di aver salvato le classi compilate nella dir classes e di trovarsi in tale directory, per eseguire questo programma occcorre inviare il comando

java scacchi/prova/Prova

Se le classi compilate si trovano nella stessa directory dei sorgenti, lo stesso comando dovrà essere immesso trovandosi nella directory src.

Si osservi che il vero programma di prova che si userà per verificare il progetto sarà quello nella classe Prova del package scacchi. Questo programm non può però essere usato (o meglio al momento termina con errori di esecuzione) fino a che il progetto non sarà completato e la versione vuota di PartitaScacchi contenuta nel package scacchi.soluzione sostituita con quella sviluappata come soluzione del progetto.

Come generare la documentazione

Per generare la documentazione (anche quella relativa alla soluzione del progetto da voi scirtta), trovandosi nella directory progetto si deve eseguire il seguenete comando

javadoc -private -d doc -sourcepath src scacchi scacchi.main scacchi.soluzione scacchi.prova