this → Artikel Baru – ( Atrikel Lama ↓ )

3 Jenis Utama Teks Komentar pada Bahasa Pemrograman Java

Waktu Publikasi Labels: Location: Semarang, Kota Semarang, Jawa Tengah, Indonesia
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"); 
} 
} 

Pahami pula, tentang semua konsep desain Web untuk tingkat pemula melalui materi lengkap JAVA [klik].


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 */


Baca juga, tentang materi bahasa pemrograman lainnya melalui Materi Lengkap 

Bahasa Pemrograman [klik].


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 nested. sintak: {@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 section. sintak:  @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
Dipublikasikan Oleh
Bekerja Sebagai Guru TIK di Kota Semarang, yang memanfaatkan blog sebagai sarana pendidikan dan informasi.

Komentar

  1. AnonimSelasa, 04 Mei 2021 08.34.00 WIB

    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. MauludiSelasa, 04 Mei 2021 08.35.00 WIB

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

    BalasHapus
  3. AnonimSelasa, 04 Mei 2021 08.36.00 WIB

    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. AnonimSelasa, 04 Mei 2021 08.37.00 WIB

    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. AnonimSelasa, 04 Mei 2021 08.37.00 WIB

      lali kabeh tah, isi kode yang dibuat hohoo

      Hapus

Posting Komentar

Respon komentar 7 x 24 jam, mohon bersabar jika komentar tidak langsung dipublikasi atau mendapatkan balasan secara langsung. :D

Catatan: setiap iklan yang ditayangkan pada blog ini bersumber dari google adsense. Dengan jenis iklan yang dipilih adalah, sebagai berikut.

POIN 1, Iklan yang ditampilkan hanya boleh berbahasa indonesia atau berbahasa inggris. Tidak menerima jenis iklan dalam bahasa yang lain selain yang telah disebutkan karena blog ini dibuat untuk para pengunjung dari negara atau orang yang berbahasa Indonesia.

POIN 2, Setiap gambar yang ditampilkan pada iklan sifatnya tidak mengganggu para pengunjung yang melihat blog, atau tidak boleh menampilkan gambar yang bersifat menjijikkan atau merangsang rasa mual.

POIN 3, Jenis iklan yang dipasang bukan merupakan iklan spam, atau berisi dan mengarahkan pengunjung ke alamat yang berbahaya atau bersifat penipuan.

POIN 4, Segala bentuk iklan tunduk dan patuh pada ketentuan dari pihak Adsense google dan pemilik blog.

POIN 5, Segala jenis iklan yang tidak bertentangan dengan poin 1-4 yang dijelaskan sebelumnya, maka iklan tersebut dapat ditampilkan pada blog.



~ Ikatlah Ilmu dengan Memostingkannya ~

Hot Artikel

Enkapsulasi pada Java

Waktu Publikasi 22 komentar
Enkapsulasi didefinisikan sebagai pembungkusan data dalam satu buah unit. Enkapsulasi adalah mekanisme yang mengikat code program dan data yang dimanipulasi secara bersamaan pada bahasa pemrograman Java. Cara lain untuk berpikir mengenai enkapsulasi adalah upaya untuk melindungi atau sebagai perisai proteksi yang mencegah data untuk diakses oleh pihak luar.
Tampilan Selengkapnya »

Perbedaan stdio.h dan stdlib.h pada Bahasa C

Waktu Publikasi 7 komentar
Terdapat dua file header penting yang digunakan dalam bahasa C. Pertama, "<stdio.h>" adalah file header untuk standar input dan output , dan kedua "<stdlib.h>" adalah header file untuk standar library . Salah satu cara mudah untuk membedakan kedua file header tersebut adalah "<stdio.h>" mengandung deklarasi dari printf() dan scanf() , sementara "<stdlib.h>" mengandung deklarasi dari malloc() dan free() . Secara umum, perbedaan kedua file header tersebut adalah "<stdio.h>" mengandung informasi header untuk file yang berkaitan dengan fungsi nilai input output pada program, sedangkan "<stdlib.h>" mengandung informasi untuk fungsi alokasi memori dan pembebasan alokasi memori.
Tampilan Selengkapnya »

Penjelasan Singkat tentang Konsep Asosiasi, Komposisi, dan Agregasi pada Java

Waktu Publikasi 6 komentar
Gambar
Dalam artikel ini akan dijelaskan fungsi dari asosiasi, komposis, dan agregasi yang merupakan bentuk-bentuk hubungan antar  object  dalam OOP Java. Asosiasi   Asosiasi adalah hubungan antara dua  class  terpisah yang terbentuk melalui  object -nya. Asosiasi bisa berupa  one-to-one ,  one-to-many ,  many-to-one ,  many-to-many . Pada pemrograman berorientasi  object ,  object  berkomunikasi dengan  object  lainnya menggunakan fungsi dan  services  yang disediakan oleh  object . Komposisi dan agregasi adalah dua bentuk dari asosiasi seperti diperlihatkan pada  gambar 1 .
Tampilan Selengkapnya »

3 Jenis Utama Looping pada Java

Waktu Publikasi 5 komentar
Gambar
Looping  pada bahasa pemrograman Java adalah fitur yang digunakan untuk memfasilitasi eksekusi program dari sekelompok instruksi atau fungsi secara berulang ketika beberapa kondisi tertentu yang menjadi syarat adalah bernilai benar. Java menyediakan tiga cara untuk melakukan eksekusi  looping  pada program. Dimana semua cara tersebut menyediakan fungsi dasar yang sama, dimana perbedaannya hanya terdapat pada sintak dan kondisi waktu eksekusi.
Tampilan Selengkapnya »