COMENTARII

COMENTARII

Una dintre metodele cele mai importante de crestere a lizibilitatii unui program este folosirea comentariilor.

Comentariile reprezinta informatii introduse intr-un program doar in ajutorul persoanelor care incearca sa-si dea seama ce anume se intampla in program. Compilatorul Java ignora total comentariile atunci cand pregateste versiunea executabila a fisierului sursa Java.

Exista trei tipuri diferite de comentarii pe care le putem utiliza in programele Java.

Prima modalitate de a introduce comentarii in program este de a il prefixa cu doua simboluri slash " // ". Orice incepe dupa aceste semne si pana la sfarsitul liniei este considerat comentariu:

int oreCredit=3; // defineste orele de credit pentru curs

Daca dorim sa introducem un comentariu care ocupa mai mult de un rand trebuie sa incepem cu combinatia "/*" si sa incheiem cu combinatia "*/".

Ultimul tip de comentariu este proiectat pentru a fi interpretabil si de catre calculator. Daca incepem comentariul cu "/**" si il incheiem cu "*/" atunci comentariul este interpretat ca reprezentand documentatia originala referitoare la functionarea clasei si a metodelor sale publice.

Acest tip de comentariu poate fi citit de utilitare ca JAVADOC din pachetul JDK. Acest utilitar foloseste aceste comentarii pentru a crea un set de pagini web care documenteaza programul, ierarhia sa de clase si metodele.