Artikel Terbaru

3 Jenis Utama Teks Komentar pada Bahasa Pemrograman Java

Komentar pada bahasa pemrograman mengambil peran penting dalam membuat program menjadi lebih mudah dibaca atau dimengerti oleh manusia dengan cara menempatkan rincian keterangan pada kode program yang diletakkan pada bagian program yang terlibat sehingga program menjadi lebih mudah untuk dipelihara dan lebih mudah untuk dilakukan debugging. Komentar yang ditulis di dalam bahasa pemrograman Java akan diabaikan oleh kompilator ketika proses kompilasi dilakukan.

Pada bahasa pemrograman Java terdapat tiga jenis teks komentar:
  • satu, single - komentar sebaris.
  • dua, multi - komentar lebih dari satu baris.
  • tiga, Komentar dokumentasi.

Teks Komentar Sebaris
Programmer level pemula biasanya menggunakan teks komentar sebaris untuk mendeskripsikan fungsi dari kode program. Teks komentar ini adalah bentuk paling mudah dan sederhana untuk digunakan.

Sintak:
// Berikan komentar disini ( Teks dalam baris ini akan dianggap sebagai Teks komentar )

Contoh program:
// Program java memperlihatkan teks komentar satu baris 

class Scomment 

public static void main(String args[]) 

// Teks komentar sebaris
System.out.println("Single line comment above"); 



Teks komentar multi baris
Digunakan untuk mendeskripsikan method secara penuh pada baris program atau potongan dari baris program yang komplek tanpa perlu menambahkan '//' pada tiap baris baru.

Sintak:
/* Awal teks komentar
komentar selanjutnya
komentar selanjutnya
.
.
.
akhir teks komentar */

Contoh program:

// Program Java memperlihatkan

// teks komentar multi baris 

 

class Scomment 

 

public static void main(String args[]

System.out.println("Komentar"

+" multibaris diperlihatkan"

+" pada baris berikut."); 

 

/* teks komentar baris 1 

teks komentar baris 2 

teks komentar baris 3*/

 

}

 

}


Dapat juga digunakan untuk teks komentar satu baris seperti contoh berikut ini:
/* Komentar baris 1 */

Teks komentar dokumentasi
Tipe teks komentar ini umumnya digunakan ketika menulis kode program untuk project atau package perangkat lunak. Teks komentar dokumentasi digunakan untuk membantu menghasilkan dokumentasi referensi yang dapat digunakan untuk mendapatkan informasi tentang keterangan dari fungsi method, parameter, dan lain sebagainya.

Sintak:
/** Teks komentar dimulai
*
* tags digunakan untuk memesan parameter spesifik
* atau method dan heading
* HTML tags juga dapat digunakan 
* seperti <h1>
*
* akhir teks komentar*/

Beberapa tag yang dapat digunakan pada teks komentar dokumentasi
catatan: Penggunaan dari tag akan dapat digunakan secara otomatis pada kompilator perangakt lunak. Jika pembuatan class Java menggunakan notepad maka fungsi dari komentar dokumentasi tidak akan terlihat kegunaannya.

  • satu, Menambahkan nama author dalam class Java. sintak: @author name-text
  • dua, Menampilkan teks dalam huruf tanpa menerjemahkan sebagai teks HTML atau tag javadoc nestedsintak: {@code text}
  • tiga, Menampilkan jalur relatif dari hasil dokumentasi jalur penyimpanan pada hasil halaman apapun. sintak: {@docRoot}
  • empat, Menambahkan komentar yang mengindikasikan API tidak lagi digunakan. sintak: @deprecated deprecatedtext
  • lima, Menambahkan subheading throw pada dokumentasi yang dihasilkan, dengan nama class dan deskripsi teks. sintak: @exception class-name description
  • enam, Mewariskan komentar dari class turunan atau implementasi interface terdekat. sintak: Inherits a comment from the immediate surperclass
  • tujuh, Menambahkan baris link dengan visible teks label yang dituju ke dokumentasi untuk package spesifik, class, atau anggota nama dari class referensi. sintak: {@link package.class#member label}
  • delapan, Sama seperti {@link}, kecuali pada penggunaan link label yang ditampilkan pada plain teks kemudian kode huruf. sintak: {@linkplain package.class#member label}
  • sembilan, Menambahkan parameter dengan nama parameter spesifik yang diikuti oleh deskripsi spesifik untuk parameter-parameter sectionsintak:  @param parameter-name description
  • sepuluh, Menambahkan return section dengan deksripsi teks. sintak: @return description
  • sebelas, Menambahkan "See Also" beserta link atau teks yang mengacu pada referensi yang dituju. sintak: @see reference
  • dua_belas, Digunakan dalam komentar dokumen untuk bidang serialisasi otomatis. sintak: @serial field-description | include | exclude
  • tiga_belas, Dokumentasi dari data yang ditulis oleh method writeObject() atau writeExternal(). sintak: @serialData data-description
  • empat_belas, Dokumentasi dari komponen ObjectStreamFiel. sintak: @serialField field-name field-type field-description
  • lima_belas, Menambahkan "Since" heading dengan spesifikasi teks waktu untuk hasil dokumentasi. sintak: @since release
  • enam_belas, Penggunaan @throws dan @exception tag adalah sama. sintak: @throws class-name description
  • tujuh_belas, Ketika {@value} digunakan dalam komentar dokumen dari bidang statis, maka akan menampilkan nilai dari konstanta. sintak: {@value package.class#field}
  • delapan_belas, Menambahkan "Version" subheading dengan spesifikasi teks versi menuju hasil dokumentasi ketika "version" digunakan. sintak: @version version-text

Contoh Program:

// Program Java

// mengilustrasikan periode

// penggunaan 

 

// dari tag-tag komentar 

 

/** 

* <h1>

menemukan nilai rata-rata dari tiga nilai!</h1>

* program FindAvg program implements pada applikasi sederhana 

* yang menghitung nilai rata-rata dari tiga bilangan integer 

* dan mencetak hasilnya pada layar monitor

* @author Elfan Mauludi 

* @version 1.0 

* @since 2019-03-18 

*/

 

public class FindAvg 

/** 

* Method ini digunakan untuk mencari nilai rata-rata dari tiga bilangan integer. 

* @param numA parameter pertama untuk method findAvg 

* @param numB paramater kedua untuk method findAvg 

* @param numC parameter ketiga untuk method findAvg 

* @return int mengembalikan nilai rata-rata dari numA, numB, dan numC. 

*/

public int findAvg(int numA, int numB, int numC

return (numA + numB + numC)/3

 

/** 

* method utama membuat method findAvg method dapat dijalankan. 

* @param args tidak digunakan. 

* @return tidak mengembalikan nilai apapun. 

*/

 

public static void main(String args[]

FindAvg obj = new FindAvg(); 

int avg = obj.findAvg(10, 20, 30); 

 

System.out.println("Nilai"

+" rata-rata dari 10, 20,"

+" dan 30 adalah :" 

+ avg); 

}

Output:
Nilai rata-rata dari 10, 20, dan 30 adalah :20

Kode dokumentasi pada contoh program sebelumnya dihasilkan menggunakan tools 'javadoc'. Javadoc dapat dijalankan dengan cara menggunakan perintah berikut ini pada cmd.
javadoc FindAvg.java

Komentar

  1. Perintah komentar dapat digunakan untuk menjelaskan kode pada program java, dan membuat kode program tersebut menjadi lebih muda untuk dibaca. Komentar juga dapat digunakan untuk mencegah eksekusi ketika proses pengujian kode alternatif. Komentar satu baris dimulai dengan dua garis miring (//). Teks apapun yang terletak diantara kode // akan dianggap sebagai teks komentar dan segala perintah yang terdapat pada baris tersebut akan diabaikan oleh kompilator Java atau tidak akan dieksekusi.

    BalasHapus
  2. Programmer yang hebat adalah programmer yang berani membuat program tanpa menggunakan teks komentar hahaha

    BalasHapus
  3. Baris komentar berisi komentar rinci tentang penjelasan suatu teks atau apapun. Ada dua cara untuk dapat menulis komentar pada baris program Java. Pertama, baris komentar tunggal dan baris komentar bertingkat.

    Baris komentar juga terkadang disebuat sebagai penjelasan program yang juga dapat dibaca oleh program itu sendiri.

    BalasHapus
  4. Pengalaman awal waktu belajar koding, dengan bangganya buat project tanpa disertai komentar yang menganggap kalo kode komentar tersebuat hanya akan membebani program dan tidak efisien, JEBULEEE

    BalasHapus
    Balasan
    1. lali kabeh tah, isi kode yang dibuat hohoo

      Hapus

Posting Komentar

Respon komentar 7 x 24 jam, so please be patient :D

Hot Artikel!!!

Enkapsulasi pada Java

6 Tahap Utama dalam Melakukan Kompilasi Program Hello World Java

6 Contoh Program Method Overloading pada Java