Cerca all'interno del corso
Ricevi un trucco a settimana !!

Specifiche Sun

Commenti di documentazione, Inizializzazione, Posizione e Dichiarazioni di Classe e Interfaccia
Lezione 4
Parte 2 di 6

 

Vedi anche i corsi correlati:


Partner:


 

Notiamo che classi e interfacce ad alto livello non sono indentate, mentre lo sono i loro membri. La prima linea del commento di documentazione (/**) per classi e interfacce non è indentata; le linee di commento successive hanno ognuna 1 spazio di indentazione (per allineare verticalmente gli asterischi). I membri, inclusi i costruttori, hanno 4 spazi per la prima linea del doc comment e 5 spazi per quelli successivi.

Se si ha necessità di dare informazioni circa la classe, l’interfaccia, la variabile o il metodo, che non sono appropriate per la documentazione, usare un commento d’implementazione di blocco (vedi sezione 5.1.1) o a singola linea (vedi sezione 5.1.2) immediatamente dopo la dichiarazione. Per esempio, i dettagli sull’implementazione di una classe devono andare in un commento di blocco seguente l’istruzione class, non nel doc comment della classe.

I “doc comments” non devono essere posizionati dentro il blocco di definizione di un metodo o un costruttore, perché Java associa i commenti di documentazione con la pri ma dichiarazione dopo il commento.

 


   
Home Page

A Cura di Angelo Carpenzano (©)

Scarica questa lezione: Clicca qui per scaricare la lezione


 

Segnala questa lezione ad un amico!
Nome Amico:
eMail Amico:
Tuo Nome:
Regalagli anche la Newsletter di questo corso!