naming в Java

Дайте числу ясное имя, чтобы снова использовать то же написание. В Yard.java напишите int ticketCount = 4; и напечатайте ticketCount. Скомпилируйте через javac Yard.java и запустите java Yard. Экран должен показать 4. Вторая демо хранит 4 под ticketCount и 9 под TicketCount, затем печатает оба имени. Экран должен показать 4, затем 9, потому что эти написания в Java — разные имена. Правила форматирования оставьте следующей странице — этот урок про точное именование, а не про стиль пробелов.

Сохраните одно ясное имя

Страница Javadoc пометила контракт метода. Эта страница выбирает читаемые имена для значений, которые вы сохраняете. Откройте Yard.java. Держите имя public-класса Yard. Удалите оставшиеся демо add, если они хоронят историю именования, оставшиеся метки println отладки, которые только охотятся за неверной суммой, оставшиеся демо equals и любой клавиатурный Scanner. Программа не должна ждать ввода. Строка import не нужна.
Внутри Yard.main напишите одно имя в camelCase — начните с маленькой буквы, затем делайте заглавными следующие слова в том же имени:
int ticketCount = 4;
System.out.println(ticketCount);
Написание ticketCount и есть имя. Значение 4 сидит под этим написанием. Когда вы печатаете имя, Java ищет именно это написание и пишет сохранённое число.

Из папки, где лежит Yard.java, запустите javac Yard.java. Когда скобки, фигурные скобки и точки с запятой совпадают, javac не пишет собственной строки. Затем запустите java Yard — не java Yard.java. Уберите окончание .java из команды запуска. Держите один public-класс в файле, чтобы имя совпадало с Yard.
Экран показывает 4. Пройдите запуск один раз. Java начинает с Yard.main. Первая строка сохраняет четыре под ticketCount. Строка печати ищет ticketCount и пишет 4. В этой первой демо второго имени нет. Поиск точный. TicketCount — не то имя, которое вы сохранили в этой первой программе.
Произнесите правило новичка, глядя на экран: выберите одно написание, сохраните значение, запросите то же написание. Не изобретайте длинные лекции о форматировании на этой странице. Форматирование ждёт следующего урока.
Если вы всё ещё видите 12 из демо Javadoc с add, переключитесь на учебный файл именования и снова запустите java Yard. Если вы пишете ticket count = 4 с пробелом посередине, это не одно имя. Держите форму camelCase одним словом.

Заглавная буква создаёт второе имя

Вторая программа держит ticketCount и добавляет другое имя, которое отличается только одной заглавной буквой. Java считает ticketCount и TicketCount двумя именами. Сохраните 4 под первым написанием и 9 под вторым, затем напечатайте оба.

Скомпилируйте через javac Yard.java, затем запустите java Yard. Экран показывает 4, затем 9. Первая печать читает ticketCount. Вторая печать читает TicketCount. Это не один и тот же поиск. Смена регистра одной буквы создаёт новое имя. Новички часто ждут, что второе написание обновит первое. На этой странице этого нет. Каждое написание держит своё значение.
Прочитайте два объявления ещё раз. Имя класса Yard остаётся в PascalCase с заглавной первой буквой — это совпадает с именем файла. Имена значений в main показывают контраст: camelCase ticketCount для обычной переменной и намеренно другое TicketCount только чтобы доказать чувствительность к регистру. В повседневном коде вы всё равно предпочитаете camelCase для переменных; второе имя здесь — учебный контраст, а не стиль, который стоит копировать повсюду.
Если рядом ещё лежат демо Javadoc, оставьте их как историю. Для этого урока запускайте учебный файл именования, чтобы экран показывал именованные счётчики, а не только задокументированный результат add. Если javac жалуется на дублирующие public-классы, держите public только у Yard.

Имена, с которых нельзя начинать

Имя не должно начинаться с цифры. Строка вроде int 4tickets = 4; намеренно отсутствует в этих демо. Такая форма в Java незаконна, поэтому javac отклоняет её до запуска программы. В реальной работе держите первый символ буквой или подчёркиванием. Рабочие демо этой страницы начинаются с t или T.
Пробел внутри имени тоже ломает запись. ticket count — два токена, а не одно имя. camelCase соединяет слова без пробелов: ticketCount. Держите эту привычку, когда сами назовёте следующую переменную.
Таблица на этой странице не нужна. Два экрана — карта: одно имя печатает 4; два имени с разным регистром печатают 4, затем 9.

Сравнение с метками Javadoc

На странице Javadoc @param и @return пометили контракт метода. На этой странице написание переменной — контракт для повторного поиска значения. Вы по-прежнему компилируете Yard.java и запускаете java Yard. Новая привычка — выбирать ясное имя camelCase и уважать точный регистр при обратном чтении.
Комментарии Javadoc не заменяют хорошие имена. Ясное имя и ясный комментарий позже могут стоять рядом. Этот урок изолирует именование, чтобы экран доказал регистрозависимый поиск без смешивания тегов документации в демо.
Если ещё открыт оставшийся файл add, вы можете увидеть только 12. Переключитесь на файл именования, чтобы main сохранял и печатал ticketCount. Держите руководства по стилю форматирования вне этой страницы. Держите клавиатурный ввод вне этой страницы.

Перед форматированием

Вы можете сохранить ticketCount как 4 и увидеть 4 на экране. Вы можете добавить TicketCount как 9 и увидеть 4, затем 9. Скомпилируйте Yard.java и запустите java Yard для каждой сохранённой демо по очереди. Написание решило, какое значение появится. Следующая страница — форматирование, где вы приводите в порядок пробелы и расположение кода для читателей.
Держите демо с одним именем для ясной первой печати. Держите демо с двумя именами для ясного контраста регистра. Держите файлы форматирования вне этой страницы до того урока. Эти три привычки — контрольная точка перед переходом. Когда то же написание возвращает сохранённое значение — а другая заглавная буква это значение не крадёт — именование сделало своё дело для этого урока, и вы готовы к следующей теме о форматировании.
Ещё один проход по папке: один public Yard, ясные имена в main, без ожидания клавиатуры, без принудительных правил форматирования. Ещё раз запустите javac Yard.java и java Yard на демо, которую держите открытой. Если экран всё ещё совпадает с именами, которые вы набрали, урок именования крепок, и курс может перейти к форматированию на следующей странице. Предпочитайте одну идею именования на запуск, чтобы каждый экран учил один контраст.