Difference between revisions of "JAVA: Konvensi Penamaan di Java"

From OnnoWiki
Jump to navigation Jump to search
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Seorang programmer dikatakan menulis clean code, pada saat penamaan harus baik supaya programmer lain dapat dengan mudah membaca code/program yang dibuat. Pada tingkat rendah, tampaknya ini tidak ada artinya tapi jika kita lihat pada tingkat industri dimana perlu menulis clean code untuk menghemat waktu di mana ada aturan tertentu yang ditetapkan yang salah satu faktornya adalah memberi nama keyword yang tepat yang disebut sebagai konvensi penamaan di Java.
 
Seorang programmer dikatakan menulis clean code, pada saat penamaan harus baik supaya programmer lain dapat dengan mudah membaca code/program yang dibuat. Pada tingkat rendah, tampaknya ini tidak ada artinya tapi jika kita lihat pada tingkat industri dimana perlu menulis clean code untuk menghemat waktu di mana ada aturan tertentu yang ditetapkan yang salah satu faktornya adalah memberi nama keyword yang tepat yang disebut sebagai konvensi penamaan di Java.
  
 +
Misalnya ketika kita menggunakan nama variabel yang menggambarkan perpindahan maka itu harus dinamai sebagai "displace" atau serupa juga tidak mungkin x, d yang menjadi kompleks ketika code berkembang dan mengurangi keterbacaan dari code tersebut. Perhatikan ilustrasi di bawah ini untuk mendapatkan pemahaman yang lebih baik yang nanti akan kita bahas secara rinci.
  
 +
'''Ilustrasi:'''
  
 +
* '''Class:''' Jika kita menamai Class apa pun maka itu harus berupa kata benda dan karenanya harus dinamai sesuai tujuan yang ingin dicapai dalam program seperti Add2Numbers, ReverseString, dan sebagainya dan tidak mungkin A1, Pemrograman, dll. Itu harus secara spesifik menunjuk apa tepatnya ada di dalam tanpa melirik isi / body Class.
 +
* '''Interface:''' Jika kita menamai interface, itu akan terlihat seperti kata sifat seperti pertimbangkan yang sudah ada: Runnable, Serializable, dll. Coba gunakan 'able' di akhir, ya dikatakan mencoba karena tidak ada ikatan aturan yang kuat dan rigid bayangkan jika kita menggunakan interface inbuilt seperti 'Remote', yang jelas-jelas tidak memiliki ble di akhirnya. Pertimbangkan jika kita seharusnya membuat interface untuk melakukan operasi baca maka disarankan sesuai konvensi penamaan di java untuk memberi nama interface 'Readable' atau yang serupa.
 +
* '''Methods:''' Jika kita perhatikan lebih dekat dari suatu method maka seharusnya melakukan sesuatu yang terkandung di dalam tubuhnya oleh karena itu harus menggunakan kata kerja.
 +
* '''Constants:''' Pada saat membaca namanya harus memperlihatkan bahwa nilai tersebut adalah fix / tetap, misalnya misalnya PI, MAX_INT, MIN_INT, dll.
  
For example when you are using a variable name depicting displacement then it should be named as “displace” or similar likewise not likely x, d which becomes complex as the code widens up and decreases the readability aperture. Consider the below illustrations to get a better understanding which later on we will be discussing in detail.
 
  
Illustrations:
 
  
Class: If you are naming any class then it should be a noun and so should be named as per the goal to be achieved in the program such as Add2Numbers, ReverseString, and so on not likely A1, Programming, etc. It should be specific pointing what exactly is there inside without glancing at the body of the class.
+
==Konvensi Penamaan di Java==
Interface: If you are naming an interface, it should look like an adjective such as consider the existing ones: Runnable, Serializable, etc. Try to use ‘able’ at the end, yes it is said to try as there are no hard and fast bound rules as if we do consider an inbuilt interface such as ‘Remote’, it is not having ble at the end. Consider if you are supposed to create an interface to make read operation then it is suggested as per naming conventions in java to name a similar likely ‘Readable’ interface.
 
Methods: Now if we do look closer a method is supposed to do something that it does contains in its body henceforth it should be a verb.
 
Constants: As the name suggests it should look like as we read it looks like it is fixed for examples PI, MAX_INT, MIN_INT, etc as follows.
 
Naming Conventions in Java  
 
In java, it is good practice to name class, variables, and methods name as what they are actually supposed to do instead of naming them randomly. Below are some naming conventions of the java programming language. They must be followed while developing software in java for good maintenance and readability of code. Java uses CamelCase as a practice for writing names of methods, variables, classes, packages, and constants.
 
  
Camel’s case in java programming consists of compound words or phrases such that each word or abbreviation begins with a capital letter or first word with a lowercase letter, rest all with capital. Here in simpler terms, it means if there are two
+
Di java, adalah praktik yang baik untuk memberi nama Class, Variable, dan nama method sebagai apa yang seharusnya mereka lakukan daripada menamainya secara acak. Di bawah ini adalah beberapa konvensi penamaan bahasa pemrograman java. Mereka harus diikuti saat mengembangkan perangkat lunak di java untuk pemeliharaan dan keterbacaan code yang baik. Java menggunakan CamelCase sebagai praktik untuk menulis nama method, Variable, Class, Package, dan Constant.
  
Note: Do look out for these exceptioj cases to camel casing in java as follows:
+
Camel's Case dalam pemrograman java terdiri dari kata atau frasa majemuk sedemikian rupa sehingga setiap kata atau singkatan dimulai dengan huruf kapital atau kata pertama dengan huruf kecil, sisanya semua dengan kapital. Di sini dalam istilah yang lebih sederhana, itu berarti jika ada dua.
  
In package, everything is small even while we are combining two or more words in java
+
Catatan: Perhatikan kasus-kasus exception ini untuk camel casing di java sebagai berikut:
In constants, we do use everything as uppercase and only ‘_’ character is used even if we are combining two or more words in java.
+
* Di package, semuanya huruf kecil bahkan saat kita menggabungkan dua kata atau lebih di java
Type 1: Classes and Interfaces
+
* Di constant, kita menggunakan huruf besar semuanya dan karakter '_' yang digunakan jika ingin menggabungkan dua kata atau lebih di java.
  
Class names should be nouns, in mixed cases with the first letter of each internal word capitalized. Interfaces names should also be capitalized just like class names.
 
Use whole words and must avoid acronyms and abbreviations.
 
  
Classes: class Student { }
+
===Type 1: Class dan Interface===
          class S=Integer {}
 
          class Scanner {}
 
Interfaces : Runnable
 
              Remote
 
              Seriazable
 
  
Type 2: Methods
+
Nama Class harus berupa kata benda, dalam kasus campuran dengan huruf pertama setiap kata menggunakan huruf besar.
 +
Nama Interface juga harus dikapitalisasi seperti nama Class.
 +
Gunakan seluruh kata dan hindari akronim dan singkatan.
  
Methods should be verbs, in mixed case with the first letter lowercase and with the first letter of each internal word capitalized.
+
Class: class Student { }
public static void main(String [] args)  {}
+
        class S=Integer {}
As the name suggests the method is supposed to be primarily method which indeed it is as main() method in java is the method from where the program begins its execution.
+
        class Scanner {}
  
Type 3: Variables
+
Interface : Runnable
 +
            Remote
 +
            Seriazable
  
Variable names should be short yet meaningful.
+
===Type 2: Method===
  
Variable names should not start with underscore _ or dollar sign $ characters, even though both are allowed.
+
Method harus berupa kata kerja, dalam huruf besar campuran dengan huruf pertama huruf kecil dan dengan huruf pertama setiap kata internal dikapitalisasi.
Should be mnemonic i.e, designed to indicate to the casual observer the intent of its use.
 
One-character variable names should be avoided except for temporary variables.
 
Common names for temporary variables are i, j, k, m, and n for integers; c, d, and e for characters.
 
int[] marks;
 
double double answer,
 
As the name suggests one stands for marks while the other for an answer be it of any e do not mind.
 
  
Type 4: Constant variables
+
public static void main(String [] args)  {}
  
Should be all uppercase with words separated by underscores (“_”).
+
Seperti namanya, method ini seharusnya menjadi metode utama yang memang seperti method main() di java adalah method dari mana program memulai eksekusinya.
There are various constants used in predefined classes like Float, Long, String etc.
 
num = PI;
 
Type 5: Packages
 
  
The prefix of a unique package name is always written in all-lowercase ASCII letters and should be one of the top-level domain names, like com, edu, gov, mil, net, org.
+
===Type 3: Variable===
Subsequent components of the package name vary according to an organization’s own internal naming conventions.
 
java.util.Scanner ;
 
java.io.*;
 
As the name suggests in the first case we are trying to access the Scanner class from the java.util package and in other all classes(* standing for all) input-output classes making it so easy for another programmer to identify.
 
  
Note:
+
Nama variabel harus singkat namun bermakna.
  
For class and interfaces, the first letter has to be uppercase.
+
Nama variabel tidak boleh dimulai dengan karakter garis bawah _ atau tanda dolar $, walaupun keduanya diperbolehkan.
For method , variable, package_name, and constants, the first letter has to be lowercase.
+
Harus mnemonic yaitu, dirancang untuk menunjukkan kepada pengamat biasa maksud penggunaannya.
 +
Nama variabel satu karakter harus dihindari kecuali untuk variabel sementara.
 +
Nama umum untuk variabel sementara adalah i, j, k, m, dan n untuk bilangan bulat; c, d, dan e untuk karakter.
  
 +
int[] marks;
 +
double double answer,
  
 +
Seperti namanya, satu singkatan dari tanda sementara yang lain untuk jawaban baik itu dari e tidak keberatan.
 +
 +
===Type 4: Constant variable===
 +
 +
Harus huruf besar semua dengan kata-kata yang dipisahkan dengan garis bawah (“_”).
 +
Ada berbagai konstanta yang digunakan di Class yang telah ditentukan seperti Float, Long, String dll
 +
 +
num = PI;
 +
 +
===Type 5: Package===
 +
 +
Awalan nama paket harus unik dan selalu ditulis dengan huruf kecil dan harus salah satu dari nama domain tingkat atas, seperti com, edu, gov, mil, net, org.
 +
Komponen selanjutnya dari nama paket bervariasi sesuai dengan konvensi penamaan internal organisasi itu sendiri.
 +
 +
java.util.Scanner ;
 +
java.io.*;
 +
 +
Seperti namanya dalam kasus pertama, kami mencoba mengakses Scanner Class dari paket java.util dan di semua Class lainnya (* berarti semua) kelas input-output sehingga memudahkan pemrogram lain untuk mengidentifikasi.
 +
 +
Catatan:
 +
* Untuk kelas dan antarmuka, huruf pertama harus huruf besar.
 +
* Untuk metode, variabel, nama_paket, dan konstanta, huruf pertama harus huruf kecil.
  
 
==Referensi==
 
==Referensi==
  
 
* https://www.geeksforgeeks.org/java-naming-conventions/
 
* https://www.geeksforgeeks.org/java-naming-conventions/

Latest revision as of 05:33, 3 May 2022

Seorang programmer dikatakan menulis clean code, pada saat penamaan harus baik supaya programmer lain dapat dengan mudah membaca code/program yang dibuat. Pada tingkat rendah, tampaknya ini tidak ada artinya tapi jika kita lihat pada tingkat industri dimana perlu menulis clean code untuk menghemat waktu di mana ada aturan tertentu yang ditetapkan yang salah satu faktornya adalah memberi nama keyword yang tepat yang disebut sebagai konvensi penamaan di Java.

Misalnya ketika kita menggunakan nama variabel yang menggambarkan perpindahan maka itu harus dinamai sebagai "displace" atau serupa juga tidak mungkin x, d yang menjadi kompleks ketika code berkembang dan mengurangi keterbacaan dari code tersebut. Perhatikan ilustrasi di bawah ini untuk mendapatkan pemahaman yang lebih baik yang nanti akan kita bahas secara rinci.

Ilustrasi:

  • Class: Jika kita menamai Class apa pun maka itu harus berupa kata benda dan karenanya harus dinamai sesuai tujuan yang ingin dicapai dalam program seperti Add2Numbers, ReverseString, dan sebagainya dan tidak mungkin A1, Pemrograman, dll. Itu harus secara spesifik menunjuk apa tepatnya ada di dalam tanpa melirik isi / body Class.
  • Interface: Jika kita menamai interface, itu akan terlihat seperti kata sifat seperti pertimbangkan yang sudah ada: Runnable, Serializable, dll. Coba gunakan 'able' di akhir, ya dikatakan mencoba karena tidak ada ikatan aturan yang kuat dan rigid bayangkan jika kita menggunakan interface inbuilt seperti 'Remote', yang jelas-jelas tidak memiliki ble di akhirnya. Pertimbangkan jika kita seharusnya membuat interface untuk melakukan operasi baca maka disarankan sesuai konvensi penamaan di java untuk memberi nama interface 'Readable' atau yang serupa.
  • Methods: Jika kita perhatikan lebih dekat dari suatu method maka seharusnya melakukan sesuatu yang terkandung di dalam tubuhnya oleh karena itu harus menggunakan kata kerja.
  • Constants: Pada saat membaca namanya harus memperlihatkan bahwa nilai tersebut adalah fix / tetap, misalnya misalnya PI, MAX_INT, MIN_INT, dll.


Konvensi Penamaan di Java

Di java, adalah praktik yang baik untuk memberi nama Class, Variable, dan nama method sebagai apa yang seharusnya mereka lakukan daripada menamainya secara acak. Di bawah ini adalah beberapa konvensi penamaan bahasa pemrograman java. Mereka harus diikuti saat mengembangkan perangkat lunak di java untuk pemeliharaan dan keterbacaan code yang baik. Java menggunakan CamelCase sebagai praktik untuk menulis nama method, Variable, Class, Package, dan Constant.

Camel's Case dalam pemrograman java terdiri dari kata atau frasa majemuk sedemikian rupa sehingga setiap kata atau singkatan dimulai dengan huruf kapital atau kata pertama dengan huruf kecil, sisanya semua dengan kapital. Di sini dalam istilah yang lebih sederhana, itu berarti jika ada dua.

Catatan: Perhatikan kasus-kasus exception ini untuk camel casing di java sebagai berikut:

  • Di package, semuanya huruf kecil bahkan saat kita menggabungkan dua kata atau lebih di java
  • Di constant, kita menggunakan huruf besar semuanya dan karakter '_' yang digunakan jika ingin menggabungkan dua kata atau lebih di java.


Type 1: Class dan Interface

Nama Class harus berupa kata benda, dalam kasus campuran dengan huruf pertama setiap kata menggunakan huruf besar. Nama Interface juga harus dikapitalisasi seperti nama Class. Gunakan seluruh kata dan hindari akronim dan singkatan.

Class: class Student { }
       class S=Integer {}
       class Scanner {}
Interface : Runnable
            Remote
            Seriazable

Type 2: Method

Method harus berupa kata kerja, dalam huruf besar campuran dengan huruf pertama huruf kecil dan dengan huruf pertama setiap kata internal dikapitalisasi.

public static void main(String [] args)  {}

Seperti namanya, method ini seharusnya menjadi metode utama yang memang seperti method main() di java adalah method dari mana program memulai eksekusinya.

Type 3: Variable

Nama variabel harus singkat namun bermakna.

Nama variabel tidak boleh dimulai dengan karakter garis bawah _ atau tanda dolar $, walaupun keduanya diperbolehkan. Harus mnemonic yaitu, dirancang untuk menunjukkan kepada pengamat biasa maksud penggunaannya. Nama variabel satu karakter harus dihindari kecuali untuk variabel sementara. Nama umum untuk variabel sementara adalah i, j, k, m, dan n untuk bilangan bulat; c, d, dan e untuk karakter.

int[] marks;
double double answer,

Seperti namanya, satu singkatan dari tanda sementara yang lain untuk jawaban baik itu dari e tidak keberatan.

Type 4: Constant variable

Harus huruf besar semua dengan kata-kata yang dipisahkan dengan garis bawah (“_”). Ada berbagai konstanta yang digunakan di Class yang telah ditentukan seperti Float, Long, String dll

num = PI;

Type 5: Package

Awalan nama paket harus unik dan selalu ditulis dengan huruf kecil dan harus salah satu dari nama domain tingkat atas, seperti com, edu, gov, mil, net, org. Komponen selanjutnya dari nama paket bervariasi sesuai dengan konvensi penamaan internal organisasi itu sendiri.

java.util.Scanner ;
java.io.*;

Seperti namanya dalam kasus pertama, kami mencoba mengakses Scanner Class dari paket java.util dan di semua Class lainnya (* berarti semua) kelas input-output sehingga memudahkan pemrogram lain untuk mengidentifikasi.

Catatan:

  • Untuk kelas dan antarmuka, huruf pertama harus huruf besar.
  • Untuk metode, variabel, nama_paket, dan konstanta, huruf pertama harus huruf kecil.

Referensi