Utilizarea convențiilor de denumire Java

O convenție de denumire este o regulă de urmat, pe măsură ce decideți ce denumire a identificatorilor dvs. (de exemplu, clasă, pachet, variabilă, metodă etc.).

De ce să folosiți convențiile privind denumirea?

Diferenti programatori Java pot avea diferite stiluri și abordări ale modului în care programează. Folosind convenții de denumire Java standard, codul lor este mai ușor de citit atât pentru ei cât și pentru alți programatori. Lectibilitatea codului Java este importantă, deoarece înseamnă că se petrece mai puțin timp pentru a înțelege ce face codul, lăsând mai mult timp pentru a-l repara sau modifica.

Pentru a ilustra acest aspect, merită menționat faptul că majoritatea companiilor de software vor avea un document care conține convențiile de denumire pe care doresc să le urmeze programatorii. Un programator nou care se familiarizează cu aceste reguli va putea înțelege codul scris de un programator care poate ar fi părăsit compania cu mulți ani înainte.

Alegeți un nume pentru identificatorul dvs.

Când alegeți un nume pentru un identificator, asigurați-vă că este semnificativ. De exemplu, dacă programul dvs. se ocupă de conturile clienților, atunci alegeți nume care să aibă sens pentru relația cu clienții și conturile acestora (de exemplu, nume de client, contDetails). Nu vă faceți griji pentru lungimea numelui. Un nume mai lung care rezumă perfect identificatorul este de preferat unui nume mai scurt, care poate fi rapid de tip, dar ambiguu.

Câteva cuvinte despre cazuri

Utilizarea cazului cu litera corectă este cheia urmării unei convenții de denumire:

• Minuscule este locul în care toate literele dintr-un cuvânt sunt scrise fără majuscule (de exemplu, în timp ce, dacă, pachet).
• Majuscule este locul în care toate literele dintr-un cuvânt sunt scrise cu majuscule. Când există mai mult de două cuvinte în nume, folosiți schemele de subsol pentru a le separa (de exemplu, MAX_HOURS, FIRST_DAY_OF_WEEK).
• CamelCase (cunoscut și sub numele de Upper CamelCase) este locul în care fiecare cuvânt nou începe cu o majusculă (de exemplu, CamelCase, CustomerAccount, PlayingCard).
• Carcasă mixtă (cunoscut și sub numele de Lower CamelCase) este același cu CamelCase, cu excepția primei litere a numelui este cu litere mici (de exemplu, hasChildren, clientFirstName, clientLastName).

Convenții de denumire Java standard

Lista de mai jos prezintă convențiile de denumire Java standard pentru fiecare tip de identificator:

• pachete: Numele trebuie să fie cu litere mici. Cu proiecte mici care au doar câteva pachete este în regulă să le dai doar nume simple (dar semnificative!):

   pachet pokeranalyzer pachet miccalculator 

  În companiile de software și proiecte mari în care pachetele ar putea fi importate în alte clase, numele vor fi în mod normal subdivizate. De obicei, acest lucru va începe cu domeniul companiei înainte de a fi împărțit în straturi sau caracteristici:

   pachet com.mycompany.utilities pachet org.bobscompany.application.userinterface 

• Clase: Numele trebuie să fie în CamelCase. Încercați să folosiți substantive, deoarece o clasă reprezintă în mod normal ceva din lumea reală:

   clasa Clasa Clasa Cont 

• interfeţe: Numele trebuie să fie în CamelCase. Acestea tind să aibă un nume care descrie o operație pe care o clasă o poate face:

   interfață Interfață comparabilă Enumerable 

  Rețineți că unii programatori le place să distingă interfețele începând numele cu un "I":

   interfață Interfață IComparabilă IEnumerable 

• metode: Numele trebuie să fie în cazuri mixte. Folosiți verbe pentru a descrie ce face metoda:

   void calculaTax () șirul getSurname () 

• variabile: Numele trebuie să fie în cazuri mixte. Numele ar trebui să reprezinte ceea ce reprezintă valoarea variabilei:

   string firstName int orderNumber 

  Utilizați nume foarte scurte doar atunci când variabilele au o durată scurtă de viață, cum ar fi în bucle:

   pentru (int i = 0; i<20;i++)    //i only lives in here  

• constante: Numele trebuie să fie cu majuscule.

   static final int DEFAULT_WIDTH static final int MAX_HEIGHT