Coemntarii în Java
Comentariile Java sunt declarațiile dintr-un program care nu sunt executate de compilator și interpretor.
De ce folosim comentariile într-un cod?
- Comentariile sunt folosite pentru a face programul mai lizibil prin adăugarea detaliilor codului.
- Este ușor să întrețineți codul și să găsiți cu ușurință erorile.
- Comentariile pot fi folosite pentru a oferi informații sau explicații despre variabilă, metodă, clasă sau orice afirmație.
- Poate fi, de asemenea, utilizat pentru a preveni executarea codului programului în timpul testării codului alternativ.
Tipuri de comentarii Java
Există trei tipuri de comentarii în Java:
- Comentariu Single Line
- Comentariu Multi Line
- Comentariu Document
Comentariul cu o singură linie este utilizat pentru a comenta doar o singură linie din cod. Este cel
mai utilizat și mai ușor mod de a comenta afirmațiile.
Comentariile cu o singură linie încep cu două bare oblice înainte (//). Orice text din fața // nu
este executat de Java.
Sintaxa:
// Acesta este un comentariu Single Line
Comentariul cu mai multe linii este utilizat pentru a comenta mai multe linii de cod. Poate fi folosit
pentru a explica un fragment de cod complex sau pentru a comenta mai multe linii de cod la un moment dat
(deoarece va fi dificil să folosiți comentarii cu o singură linie acolo).
Comentariile pe mai multe linii sunt plasate între / * și * /. Orice text între / * și * / nu este
executat de Java.
Sintaxa:
/*
Acesta
este
un comentariu
Multi Line
*/
Comentariile despre documentație sunt de obicei utilizate pentru a scrie programe mari pentru un proiect
sau o aplicație software, deoarece ajută la crearea documentației API. Aceste API-uri sunt necesare
pentru referință, adică care clase, metode, argumente etc. sunt utilizate în cod.
Pentru a crea API de documentare, trebuie să folosim instrumentul javadoc. Comentariile documentației
sunt plasate între / ** și * /.
Sintaxa:
/**
*
*Putem folosi diverse etichete pentru a descrie diferiti parametrii(autor, versiune)
*Putem folosi și etichete HTML
*
*/