Конвенция именования
Конвенция именования делает программу более легко читаемой и понятной. Также она может давать информацию о функции идентификатора, например, указывает ли идентификатор на константу, пакет или класс, что может быть полезным в понимании кода.
Тип идентификатора
Правила именования
Примеры
Пакеты
Префикс уникального имени пакета всегда пишется в нижнем регистре латиницей и должен соответствовать одному из доменов высшего уровня, в настоящий момент это com, edu, gov, mil, net, org, или один из английских двухбуквенных кодов, обозначающих страну по стандарту ISO 3166, 1981. Последующие компоненты могут различаться в соответствии с внутренними стандартами организации. Такие стандарты могут предписывать использование названий департаментов, отделов, проектов, оборудования или логинов.
com.sun.eng com.apple.quicktime.v2 edu.cmu.cs.bovik.cheese
Классы
Имена классов должны быть существительными. В смешанном регистре первой заглавной буквой (PascalCase). Старайтесь именовать классы коротко и ясно. Используйте целые слова, избегайте сокращений (Кроме случаев, когда сокращение гораздо распространеннее, чем полная версия, как URL или HTML).
class Raster; class ImageSprite;
Интерфейсы
Имена интерфейсов пишутся так же, как и имена классов.
interface RasterDelegate; interface Storing;
Методы
Имена методов должны быть глаголами, в смешанном регистре, начиная со строчной буквы, но с использованием заглавной буквы для каждого последующего слова (camelCase).
run(); runFast(); getBackground();
Переменные
Имена переменных не должны начинаться с подчеркивания "_" или знака доллара "$", хотя технически и то и другое возможно. Имена переменных должны быть короткими, но осмысленными. Выбор имени должен быть мнемоничен - т.е. быть таким, чтобы случайный наблюдатель мог понять, для чего используется переменная. Односимвольных имен переменных лучше избегать, за исключением временных переменных. Обычные имена для временных переменных: i, j, k, m, и n для целых чисел; c, d, и e для символов.
int i; char c; float myWidth;
Константы
Имена констант должны быть написаны полностью в верхнем регистре, с разделением слов подчеркиваниями ("_").
static final int MIN_WIDTH = 4; static final int MAX_WIDTH = 999; static final int GET_THE_CPU = 1;
Last updated