ГЛАВА 2. ОСНОВЫ ЛЕКСИКИ

Программы на языке Java – это набор пробелов, комментариев и всего остального (служебных слов, идентификаторов, литеральных констант, операторов и разделителей).

2.1 Комментарии

Хотя комментарии никак не влияют на исполняемый код программы, при правильном использовании они оказываются весьма существенной частью исходного текста. Существует три разновидности комментариев: комментарии в одной строке, комментарии в нескольких строках и, наконец, комментарии для документирования. Комментарии, занимающие одну строку, начинаются с символов «//» и заканчиваются в конце строки. Такой стиль комментирования полезен для размещениякратких пояснений котдельным строкам кода:

а = 42; // это комментарий

Для более подробных пояснений вы можете воспользоваться комментариями, размещенными на нескольких строках, начав текст комментариев символами «/*» и закончив символами «*/». При этом весь текст между этими парами символов будет расценен как комментарий и компилятор его проигнорирует. В Java многострочные комментарии не могут быть вложенными друг в друга: компилятор будет считать, что комментарий заканчивается с первыми встреченными символами «*/».

Пример 25. Многострочный комментарий

/*

это тоже комментарий

*/

Третья, особая форма комментариев, предназначена для сервисной программы javadoc, которая использует компоненты Java-

61

компилятора для автоматической генерации документации по типам. Соглашение, используемое для комментариев этого вида, таково: для того, чтобы разместить перед объявлением класса, метода или поля документирующий комментарий, нужно начать его с символов «/**». Заканчивается такой комментарий точно так же, как и обычный комментарий – символами «*/». Программа javadoc умеет различать в документирующих комментариях некоторые специальные элементы, имена которых начинаются с символа «@». Вот пример такого комментария.

Пример 26. Комментарии документирования

/**

*Этот класс умеет делать замечательные вещи.

*@see java.applet.Applet

*@version 1.2

*/

class CoolApplet extends Applet { /**

*У этого метода два параметра:

*@param key - это имя параметра.

*@param value - это значение параметра с именем key.

*/

void put (String key, Object value) {

Тэг @see создаёт перекрёстную ссылку, указывающую на другой документ javadoc. Тэг @author позволяет включить в комментарий сведения об авторе кода. Тэг @version служит для обозначения версии программного обеспечения. Тэг @param служит для документирования одного параметра метода. Для обозначения каждого параметра надлежит задавать отдельный тэг @param. Первое слово, следующее за тэгом, трактуется как наименование параметра, а остальная часть строки – как его описание.

62

2.2 Служебные слова

Служебные слова не могут применяться в качестве идентификаторов, поскольку правила их употребления строго регламентированы в самом языке. В таблице 2 перечислены служебные слова языка программирования Java.

Слова null, true, и false хотя и выглядят как служебные слова, формально относятся к числу литералов и поэтому в таблицу не включены. Отметим, что слова const и goto зарезервированы в Java, но не используются.

Кроме этого, в Java есть «зарезервированные» имена методов (см. таблицу 3). Эти методы наследуются каждым классом из класса Object, поэтому не стоит называть ваши методы одним из этих имён, если вы не хотите переопределить базовую функциональность ваших объектов.

63