Конвенции за именуване в Java

Конвенциите за именуване в Java представляват приети правила за избор на имена на пакети, класове, интерфейси, методи, променливи и константи. Компилаторът не изисква тези правила във всички случаи, но спазването им прави кода по-четим, по-предвидим и по-лесен за поддръжка.

Основните стилове, които се използват в Java, са:

  • PascalCase - всяка дума започва с главна буква: Person, ImageEditor;
  • camelCase - първата дума започва с малка буква, а всяка следваща с главна: basePrice, calculateAverageScore;
  • UPPER_SNAKE_CASE - всички букви са главни, а думите са разделени с долна черта: MIN_AGE, MAX_USERS_COUNT.
Тип идентификатор Конвенция Правила Примери
Пакет малки букви Името на пакета се изписва само с малки букви. Обикновено започва с обърнато домейн име на организацията или проекта. Избягват се главни букви, интервали и специални символи. com.example.school
bg.tu_varna.oop
Клас PascalCase Името на класа обикновено е съществително или словосъчетание, което описва какво представя класът. Трябва да бъде конкретно и информативно. class Person
class ImageEditor
Интерфейс PascalCase За интерфейсите се използва същият стил като при класовете. Името трябва да описва поведение, възможност или роля. interface Calculator
interface Printable
Метод camelCase Името на метода обикновено е глагол или глаголна фраза, защото методът извършва действие. run()
getRate()
addAverageScore()
Променлива camelCase Името на променливата трябва да описва ясно стойността, която се съхранява в нея. Избягват се еднобуквени имена, освен при кратки броячи в цикли. int age;
double basePrice;
Константа UPPER_SNAKE_CASE Константите се декларират със static final и се изписват само с главни букви. При повече от една дума думите се разделят с долна черта _. static final int MIN_AGE = 18;
static final double VAT_RATE = 0.20;

Добре подбраните имена трябва да отговарят на въпроса какво представлява даденият елемент или какво действие извършва. Например calculateTotalPrice() е по-ясно име на метод от calc() или doWork().

В рамките на курса класът, съдържащ метода main, ще бъде именуван Application. Останалите класове трябва да имат имена, които отразяват тяхното предназначение.


This site uses Just the Docs, a documentation theme for Jekyll.