1.
Lezione/esercitazione del 4/10/04 [2 ore, in AULA C] per tutti i turni
di:
Algoritmi & Laboratorio
(
Modulo 2
)
"Riassunto" della lezione:
-
Registrazione dei gruppi di laboratorio (e divisione in turni).
-
Il duplice ruolo delle classi in Java:
"stampi" per creare oggetti (es. String)
VS
"contenitori" per metodi statici (es. Math)
e/o riferimenti a oggetti del run-time (es. System).
-
Tutti i programmi che consegnerete durante il
corso dovranno essere corredati di
adeguata documentazione, prodotta utilizzandoil tool javadoc.
In particolare:
-
Quando scriverete una classe, dovrete PRIMA scrivere le intestazioni
di tutti i metodi e i commenti "javadoc", e DOPO
scrivere il corpo dei metodi.
-
I commenti dovranno sempre essere mantenuti "allineati" con il codice
(meglio non avere commenti, che avere commenti sbagliati).
-
I commenti dovranno essere scritti in italiano, in forma chiara, corretta,
sintetica, non ambigua, senza includere informazioni ridondanti o non
pertinenti, e senza omettere informazioni necessarie - DURANTE LE
ESERCITAZIONI IN LABORATORIO MOSTRATE I VOSTRI COMMENTI
AL DOCENTE E/O AI SUOI COLLABORATORI.
Nello scrivere i commenti ispiratevi allo stile usato nella documentazione
delle librerie Java.
Esercizi assegnati:
-
Imparare ad usare il tool javadoc (le spiegazioni necessarie si trovano nel
libro di testo [Hor], alle pagine indicate a lezione)
e sul manuale [Arn] (reperire le
informazioni riportate nel manuale ufficiale del linguaggio Java
e' parte integrante dell'esercizio).
DURANTE LE ESERCITAZIONI IN LABORATORIO POTETE CHIEDERE CHIARIMENTI
AL DOCENTE E/O AI SUOI COLLABORATORI.
QUESTO MATERIALE SARA' OGGETTO DI DISCUSSIONE IN SEDE DI ESAME.
-
Scrivete dei programmi Java per provare i metodi illustrate a lezione.
Commentate i files sorgente seguendo le
indicazioni contenute nei testi sopra menzionati.
Distinguete tra i commenti "pubblici",
che dovranno comparire della documentazione generata dal tool javadoc,
da quelli "privati"
(come ad es. gli invarianti di ciclo), che sono riservati agli sviluppatori
e ai manutentori del codice.
Generate la dococumentazione con il tool javadoc, prima di aver scritto
il body dei metodi.
|