- Lo strumento javadoc

Abbiamo prima accennato alla possibilità di generare della documentazione in formato HTML delle nostre classi, sul modello della documentazione delle classi standard di Java. Ciò è molto semplice, ma dobbiamo tenere conto di qualche particolare. Potremo generare documentazione solo per classi dichiarate public. Ovviamente, possiamo commentare classi, metodi, costruttori, variabili, costanti ed interfacce, (se dichiarate public)a patto di utilizzare commenti compresi tra "/**" e "*/". Il lettore è invitato a provare lo strumento javadoc commentando una qualsiasi classe dichiarata pubblica. Siamo sicuri che ne rimarrà entusiasta, comprendendone l’utilità. Digitando da riga di comando l’istruzione

    javadoc nomeFile.java

saranno generati automaticamente tutti i file HTML che servono…provare per credere…

Esercizio 3.a)

Scrivere un semplice programma che svolge le seguenti operazioni aritmetiche correttamente, scegliendo accuratamente i tipi di dati che bisogna utilizzare per immagazzinare i risultati di esse. Tenere presente la promozione automatica nelle espressioni, ed utilizzare il casting appropriatamente. In quest’esercizio, a scopo di debug, è molto utile stampare i risultati d’ogni singola operazione.

Una divisione tra due interi a=5, e b=3. Immagazzinare il risultato in una variabile r1, scegliendone il tipo di dato appropriatamente.

Una moltiplicazione tra un char c=’a’, ed uno short s=5000. Immagazzinare il risultato in una variabile r2, scegliendone il tipo di dato appropriatamente.

Una somma tra un int i=6 ed un float f=3.14F. Immagazzinare il risultato in una variabile r3, scegliendone il tipo di dato appropriatamente.

Una sottrazione tra r1, r2 e r3. Immagazzinare il risultato in una variabile r4, scegliendone il tipo di dato appropriatamente.

Verificare la correttezza delle operazioni stampandone il risultato finale.

Esercizio 3.b)

Scrivere un programma che

Utilizza una classe Persona che dichiara le variabili nome, cognome, età, codiceFiscale, indirizzo (scegliere i tipi di dati più appropriati). Ricordarsi di utilizzare le convenzioni e le regole descritte in questo modulo.

Utilizza una classe Principale che nel metodo main, istanzia due oggetti chiamati persona1 e persona2 della classe Persona, inizializzando per ognuno di essi i relativi campi sfruttando l’operatore dot.

Dichiarare un terzo reference (persona3) che punti ad uno degli oggetti già istanziati. Controllare che effettivamente persona3 punti allo oggetto voluto, stampando i campi di persona3 sempre mediante l’operatore dot.

Commentare adeguatamente le classi realizzate e sfruttare lo strumento javadoc per produrre la relativa documentazione.

Domande-osservazioni:

Nella documentazione standard di Java, sono usate tutte le regole e le convenzioni, descritte in questo capitolo. Infatti, basta osservare che String, inizia con lettera maiuscola essendo una classe. Si può concludere che anche System è una classe.