Философия Java


Пример документации


Здесь снова приведена первая Java программа, на этот раз с добавленными комментариями-документацией:

//: c02:HelloDate.java

import java.util.*;

/** Первая программа - пример Thinking in Java. * Отображает строку и сегодняшнюю дату. * @author Bruce Eckel * @author www.BruceEckel.com * @version 2.0 */

public class HelloDate { /** Единственная точка входа для класса и приложения * @param args массив строк аргументов * @return Возвращаемого значения нет * @exception Исключения не выбрасываются */

public static void main(String[] args) { System.out.println("Hello, it's: "); System.out.println(new Date()); } } ///:~

Первая строка файла использует мою собственную технику помещения ‘:’ как специальный маркер для строки комментария исходного имени файла. Эта строка содержит информацию о пути к файлу (в этом случае c02 указывает Главу 2), за которой следует имя файла [24]. Последняя строка также завершается комментарием, который означает конец исходного кода, который позволяет автоматически выбирать его из текста этой книги и проверять компилятором.




Начало  Назад  Вперед