Dalam menulis kode java , kita sebagai seorang programmer disarankan untuk menggunakan aturan-aturan atau kaidah penulisan. Standar penulisan kode java sangat penting dikarenakan alasan berikut ini :
- Setiap programmer memiliki stlye atau gaya menulis kode yang berbeda – beda, Perbedaan yang unik ini dapat memberikan dampak yang negatif ketika tedapat lebih dari satu programmer berkolaborasi mengerjakan satu project yang sama. (collaborative)
- Melakukan coding atau pemrograman java sama seperti halnya kita menulis novel atau artikel. Tujuannya adalah agar orang lain yang membaca kode kita dapat memahaminnya dengan mudah. Hal ini akan sangat terasa manfaatnya ketika ada programmer lain yang melanjutkan kode yang telah kita buat (readbility)
Itulah dua alasan mengapa menggunakan kaidah standar dalam penulisan kode java sangat penting.
Cheatsheet aturan dan kaidah penulisan identifer
- Class : CamelCase
- Variable : mixedCase
- Shortlife span variable : lowercase, boleh hanya satu huruf contoh : a,b,c,d,etc
- Package : lowercase
- methods : mixedCase
- Interface : CamelCase
Memilih Nama untuk Identifiers
Pada pemrograman java, Idenfiers adalah suatu istilah yang digunakan untuk mengeneralisasi syntax berikut ini : Nama variable, nama class, nama methods, nama packages dan nama interfaces. Variable,class,methods,package dan interface disebut sebagai identifier. Dalam menulis identifier ini hedaknya kita mengikuti kaidah berikut ini
- Memberikan nama yang memiliki arti. Contohnya seperti customer.
- Jika nama identifier lebih dari dua kata maka gunakanlah kaidah Mixed case. kata pertama dan kata dua digabung , namun pada huruf pertama dikata kedua menggunakan huruf kapital. Contohnya adalah customerName, customerAddress, customerMobilePhoneNumber dan lain sebagainnya.
- Disarankan untuk selalu menggunakna lebih dari satu kata(+penggunaan kaidah camelCase) dalam penulisan identifier agar nama identifier semakin bermakna. Bayangkan penamaan identifier variable customer yang diberikan nilai “dega”, akan lebih bermakna jika dinamakan customerName.
Jenis – jenis Cases
terdapat beberapa jenis aturan cases dalam penulisannya. Berikut adalah jenis-jenis dari penulisan case dalam kata.
- Uppercase – ini berarti huruf pertama dari kata tersebut menggunakan huruf kapital atau huruf besar. Contohnya : Nama, Alamat, Namacustomer
- Lowcase – ini berarti huruf pertama dari kata tersebut menggunakan huruf non kapital atau huruf kecil.
- camelCase – setiap huruf pertama dalam suatu kata harus menggunakan huruf besar. Contohnya adalah CustomerName, CustomerAddress, customerAge dan lain sebagiannya.
- MixedCase – dapat dikenal juga sebagai lowerCamelCase, huruf pertama pada kata pertama harus menggunakan huruf kecil Namun huruf pertama pada kata selanjutnya menggunakan huruf besar. Contohnya adalah customerName, customerAddress, customerAge dan lain sebagainnya.
Aturan penulisan standar pada java
1.Aturan penulisan pada identifier package
- Penulisan package harus menggunakan lowercase. tidak boleh adalah huruf kapital pada nama package. Contohnya adalah sebagai berikut ini
package kalkulator
- Secara umum, pada perusahaan teknologi penamaan package akan mengikuti pattern (pola) sebagai berikut ini
package com.nama_perusahaan.layer.feature
contohnya adalah sebagai berikut ini
package com.degacompanies.saas.ordermanagement.service
itulah dua aturan dalam penulisan identifier package.
2.Aturan penulisan pada identifier class
berbeda dengan penulisan identifier yang menggunakan lowercase dan mengikuti pattern atau pola tertentu , penulisan identifier class harus mengikuti penulisan CamelCase atau jika satu kata maka menggikuti aturan Uppercase. Contohnya seperti berikut ini
class Students extends Person
atau jika menggunakan lebih dari satu kata
class OrderManagement implement Serializable
3.Aturan penulisan pada identifier Interfaces
Untuk identifier interfaces sama seperti kaidah penulisan identifier class yakni menggunakan CamelCase ataupun Uppercase jika hanya satu kata. Contohnya adalah sebagai berikut ini
interface StudentsDTO
jika hanya satu kata maka
interface Book
3.Aturan penulisan pada identifier Variables
untuk penulisan variables kita harus menggunakan mixedCase. dapat dikenal juga sebagai lowerCamelCase, huruf pertama pada kata pertama harus menggunakan huruf kecil Namun huruf pertama pada kata selanjutnya menggunakan huruf besar.
Berikut adalah contohnya
int studentAge String studentAddress String studentMobilePhoneNumber
jika hanya memiliki satu kata maka gunakanlah lower case (tidak dianjurkan menuliskan nama variable dengan hanya satu kata karena tidak bermakna).
int age
penggunaan satu kata dalam variable sebenarnya diperbolehkan pada nama variable yang hanya memiliki waktu penggunaan pendek (short life variable). Contohnya adalah variable yang digunakan untuk proses looping.
package learning; public class App { public static void main(String [] args) { for(int a = 0; a<<10; a++) { System.out.println(a); } } }
4.Aturan penulisan pada identifier Methods
Penulisan method pada pemrograman java menggunakan aturan mixedCase artinnya hanya kata kedua yang menggunakan huruf kapital. Contohnya adalah sebagai berikut ini
public static Date getCurrentDate()
jika hanya satu kata maka menggunakna aturan lowercase
public void assign()
4.Aturan penulisan pada identifier Konstanta atau Constans
Konstan atau konstanta harus dituliskan dengan seluruh huruf kapital (Uppercase) dan dipisahkan oleh underscore atau garis bawah (“_”). Contohnya adalah seperti ini
private static int AGE_MULTIPIER = 28