DIPARTIMENTO   DI   INFORMATICA
Università di Torino

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:

  1. 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.
  2. 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.


[Corso di Studi di Informatica]

Last update: Oct 11, 2004