Kako koristiti komentare u Java Code

Java komentari su bilješke u datoteci Java kodova koje kompajler i runtime engine zanemaruju. Koriste se za označavanje koda radi pojašnjenja njegovog dizajna i svrhe. U Java datoteku možete dodati neograničen broj komentara, ali postoje neke "najbolje prakse" koje trebate slijediti kada koristite komentare.

Općenito, komentari koda su komentari "implementacije" koji objašnjavaju izvorni kod, kao što su opisi klasa, sučelja, metoda i polja. To su obično par redaka napisanih iznad ili pored Java koda kako bi se razjasnilo što se događa.

Druga vrsta Java komentara je Javadoc komentar. Javadoc komentari malo se razlikuju po sintaksi od komentara na implementaciju i program ih koristi javadoc.exe za generiranje Java HTML dokumentacije.

Dobra je praksa ući u naviku stavljanja Java komentara u vaš izvorni kod kako biste poboljšali svoju čitljivost i jasnoću za sebe i druge programere. Nije uvijek odmah jasno što dio Java koda radi. Nekoliko objašnjenja mogu drastično smanjiti vrijeme potrebno za razumijevanje koda.

Komentari primjene u Java kod postoje samo ljudi za čitanje. Java prevoditelje ne zanima ih i kada sastavljajući program, samo preskaču preko njih. Na veličinu i učinkovitost vašeg sastavljenog programa neće utjecati broj komentara u vašem izvornom kodu.

Komentari primjene dolaze u dva različita formata:

• Komentari retka: Za komentar s jednim retkom upišite "//" i slijedite dvije naprijed crte s vašim komentarom. Na primjer:

   // ovo je komentar u jednoj liniji
  int pogoditi broj = (int) (Math.random () * 10); 

  Kad sastavljač naiđe na dvije crte naprijed, on zna da sve što treba za njih treba smatrati komentarom. Ovo je korisno kod uklanjanja pogrešaka dijela koda. Samo dodajte komentar iz retka koda koji uklanjate pogrešku, a prevoditelj neće vidjeti:

  •  // ovo je komentar u jednoj liniji
    // int pogoditi broj = (int) (Math.random () * 10); 

    Također možete upotrijebiti dvije crte naprijed da biste završili komentare retka:

  •  // ovo je komentar u jednoj liniji
    int pogoditi broj = (int) (Math.random () * 10); // Komentar na kraju retka 

• Blokiraj komentare: Da biste započeli komentar na bloku, upišite "/ *". Sve između naprijed crte i zvjezdice, čak i ako je na drugoj liniji, tretira se kao komentar sve dok likovi "* /" ne završe komentar. Na primjer:

   / * ovo 
  je 
  
  blok
  komentar
  */
  / * tako je i ovo * /
  

Za dokumentiranje Java API-ja koristite posebne komentare Javadoca. Javadoc je alat uključen u JDK koji generira HTML dokumentaciju iz komentara u izvornom kodu.

Javadoc komentar u

.Java

/**

*/

*

Stavite ove komentare izravno iznad metode, klase, konstruktora ili bilo kojeg drugog Java elementa koji želite dokumentirati. Na primjer:

// myClass.java
/**
* Napravite ovo sažetkom rečenice koja opisuje vašu klasu.
* Evo još jednog retka.
*/
javnostklasa moj razred
{
...
}

Javadoc uključuje razne oznake koje kontroliraju način stvaranja dokumentacije. Na primjer, the

param

 / ** glavna metoda
* @param args String []
*/​
javnoststatičkiponištiti glavni (stringovi [] args)
​{
System.out.println ("Pozdrav svijetu!");
}

Mnogo drugih oznaka dostupno je u Javadocu, a također podržava HTML oznake za pomoć u kontroli rezultata. Pojedinosti potražite u vašoj Java dokumentaciji.

• Ne komentirajte. Svaki redak vašeg programa nije potrebno objašnjavati. Ako vaš program teče logično i ne dogodi se ništa neočekivano, nemojte osjećati potrebu za dodavanjem komentara.
• Unesite svoje komentare. Ako je redni kôd koji komentirate uvučen, provjerite je li vaš komentar u skladu s urezom.
• Držite komentare relevantnim. Neki programeri su izvrsni u modificiranju koda, ali iz nekog razloga zaborave ažurirati komentare. Ako se komentar više ne primjenjuje, modificirajte ga ili uklonite.
• Ne gnijezdi blok komentare. Sljedeće će rezultirati pogreškom prevoditelja:

   / * ovo 
  je
  / * Ovaj blok komentar završava prvi komentar * /
  
  blok
  komentar
  */