Utilizarea comentariilor Java

Comentariile Java sunt note dintr-un fișier cod Java care sunt ignorate de compilator și motorul de rulare. Acestea sunt utilizate pentru a adnota codul pentru a clarifica designul și scopul acestuia. Puteți adăuga un număr nelimitat de comentarii într-un fișier Java, dar există câteva „cele mai bune practici” de urmat atunci când utilizați comentarii.

În general, comentariile de cod sunt comentarii „de implementare” care explică codul sursă, cum ar fi descrieri de clase, interfețe, metode și câmpuri. Acestea sunt de obicei câteva rânduri scrise mai sus sau pe lângă codul Java pentru a clarifica ce face.

Un alt tip de comentariu Java este un comentariu Javadoc. Comentariile Javadoc diferă ușor în sintaxa față de comentariile de implementare și sunt utilizate de programul javadoc.exe pentru a genera documentația HTML Java.

De ce să folosiți Comentarii Java?

Este o practică bună să obișnuiești să introduci comentarii Java în codul sursă pentru a-i spori lizibilitatea și claritatea pentru tine și pentru alți programatori. Nu este întotdeauna clar instantaneu ce performanță are o secțiune de cod Java. Câteva linii explicative pot reduce drastic timpul necesar pentru a înțelege codul.

Ele afectează modul în care se derulează programul?

Comentariile de implementare în cod Java sunt doar pentru citirea oamenilor. Compilatorii Java nu le pasă de ei și atunci când compilează programul, doar sări peste ei. Mărimea și eficiența programului dvs. compilat nu vor fi afectate de numărul de comentarii din codul sursă.

Observații de implementare

Comentariile de implementare au două formate diferite:

Comentarii linie: Pentru un comentariu de o singură linie, tastați „//” și urmați cele două rapoarte înainte cu comentariul dvs. De exemplu:
```
 // acesta este un comentariu cu o singură linie
int guessNumber = (int) (Math.random () * 10); 
```
Când compilatorul întâlnește cele două rapoarte înainte, știe că totul trebuie să fie considerat ca un comentariu. Acest lucru este util atunci când depanați o bucată de cod. Adăugați doar un comentariu dintr-o linie de cod pe care o depanați, iar compilatorul nu o va vedea:
- ```
 // acesta este un comentariu cu o singură linie
// int guessNumber = (int) (Math.random () * 10); 
```
  De asemenea, puteți utiliza cele două butoane înainte pentru a face un comentariu la sfârșitul rândului:
- ```
 // acesta este un comentariu cu o singură linie
int guessNumber = (int) (Math.random () * 10); // Un comentariu de final de linie 
```
Comentarii blocare: Pentru a începe un comentariu de bloc, tastați "/ *". Totul dintre slash-ul înainte și asterisc, chiar dacă este pe o altă linie, este tratat ca un comentariu până când caracterele "* /" încheie comentariul. De exemplu:
```
 /* acest
este
A
bloc
cometariu
* /
/ * așa este * /
```

Comentarii Javadoc

Utilizați comentarii speciale Javadoc pentru a vă documenta API-ul Java. Javadoc este un instrument inclus în JDK care generează documentația HTML din comentarii în codul sursă.

Un comentariu Javadoc

.java

fișierele sursă sunt incluse în sintaxa de început și de sfârșit ca atare:

/ **

și

* /

. Fiecare comentariu din acestea este prefațat cu o

Plasați aceste comentarii direct deasupra metodei, clasei, constructorului sau oricărui alt element Java pe care doriți să îl documentați. De exemplu:

// myClass.java
/ **
* Faceți din aceasta o propoziție sumară care descrie clasa dvs..
* Iată o altă linie.
* /
public clasă clasa mea

...

Javadoc include diferite etichete care controlează modul în care este generată documentația. De exemplu,

@param

tag definește parametrii la o metodă:

 / ** metoda principală
* Stringul @param args []
* /
public static vid principal (String [] args)

System.out.println ("Hello World!");

Multe alte etichete sunt disponibile în Javadoc și, de asemenea, acceptă etichete HTML pentru a ajuta la controlul ieșirii. Consultați documentația Java pentru mai multe detalii.

Sfaturi pentru utilizarea comentariilor

Nu exprima comentarii. Fiecare linie a programului dvs. nu trebuie explicată. Dacă programul dvs. curge logic și nu se întâmplă nimic neașteptat, nu simțiți nevoia să adăugați un comentariu.
Indentificați comentariile. Dacă linia de cod pe care o comentați este indentată, asigurați-vă că comentariul dvs. se potrivește cu indentarea.
Păstrați comentariile relevante. Unii programatori sunt excelenți la modificarea codului, dar, din anumite motive, uitați să actualizați comentariile. Dacă un comentariu nu se mai aplică, atunci modificați sau eliminați-l.

Nu blocați comentariile. Următoarele vor avea ca rezultat o eroare a compilatorului:

 /* acest
este
/ * Acest comentariu de bloc încheie primul comentariu * /
A
bloc
cometariu
* /

Ştiinţă