Соглашения по именованию

Для того чтобы код, написанный на Java, было легко читать и понять не только его автору, но и другим разработчикам, а также для устра­нения некоторых конфликтов имен, предлагаются следующие соглаше­ния по именованию элементов языка Java. Стандартные библиотеки и классы Java также следуют им там, где это возможно.

Соглашения регулируют именование следующих конструкций:

• пакеты;

• типы (классы и интерфейсы);

• методы;

• поля;

• поля-константы;

• локальные переменные и параметры методов и др. Рассмотрим их последовательно.

Правила построения имен пакетов уже подробно рассматривались в ^ой главе. Имя каждого пакета начинается с маленькой буквы и представляет собой, как правило, одно недлинное слово. Если требуется со­ставить название из нескольких слов, можно воспользоваться знаком подчеркивания или начинать следующее слою с большой буквы. Имя па­кета верхнего уровня обычно соответствует доменному имени первого уровня. Названия Java и javax (Java extension) зарезервированы компа­нией Sun для стандартных пакетов Java.

При возникновении ситуации "заслоняющего" объявления (obscur­ing) можно изменить имя локальной переменной, что не повлечет за со­бой глобальных изменений в коде. Случай же конфликта с именем типа не должен возникать, согласно правилам именования типов.

Имена типов начинаются с большой буквы и могут состоять из не­скольких слов, каждое следующее слово также начинается с большой буквы. Конечно, надо стремиться к тому, чтобы имена были описательными, "го­ворящими".

Имена классов, как правило, являются существительными:

Human