Создание новой библиотеки классов Java

1. Выберите "File > New Project" (Ctrl-Shift-N). В области "Categories" выберите "Java". В области "Projects" выберите "Java Class Library" и нажмите "Next".
2. В поле "Project Name" введите MyLib. В поле "Project Location" укажите любой каталог на компьютере. Далее этот каталог будет называться в тексте NetBeans_projects.

   Примечание: Указанный выше путь должен отображаться в поле мастера "Project Folder" следующим образом: /NetBeans_projects/MyLib/

3. Не устанавливайте флажок "Use Dedicated Folder for Storing Libraries". (При использовании среды IDE NetBeans 6.0 эта возможность недоступна.)
4. Нажмите "Finish". Проект "MyLib" будет открыт как в окне "Projects", так и в окне "Files".

Создание нового приложения Java

1. Выберите "File > New Project". В области "Categories" выберите "Java". В области "Projects" выберите "Java Application" и нажмите "Next".
2. В поле "Project Name" введите MyApp. Проверьте, что в поле "Project Location" установлено значение NetBeans_projects.
3. Не устанавливайте флажок "Use Dedicated Folder for Storing Libraries". (При использовании среды IDE NetBeans 6.0 эта возможность недоступна.)
4. В качестве главного класса введите acrostic.Main.
5. Проверьте, что установлены флажки "Set as Main Project" и "Create Main Class".
6. Нажмите "Finish". Проект "MyApp" отображается в окне "Project", а в редакторе исходного кода открывается Main.java.

Настройка пути к классам для компиляции

Поскольку проект "MyApp" будет зависеть от класса в проекте "MyLib", необходимо добавить "MyLib" в путь к классам, указанный в "MyApp". Это также обеспечит возможность обращения классов в проекте "MyApp" к классам в проекте "MyLib" без ошибок компиляции. Кроме того, это позволит использовать функцию автозавершения кода в проекте "MyApp" для подстановки исходного кода на базе проекта "MyLib". В среде IDE путь к классам визуально представлен узлом "Libraries".

Для добавления служебных классов библиотеки в путь к классам проекта:

1. В окне "Projects" щелкните правой кнопкой мыши узел "Libraries" для проекта "MyApp" и выберите "Add Project".
2. Найдите каталог NetBeans_projects/ и выберите папку проекта MyLib. На экране "Project JAR Files" отображаются архивы JAR, которые можно добавить к проекту. Учтите, что архив JAR для проекта "MyLib" отображается даже в том случае, если он фактически еще не создан. Этот архив JAR будет создан в процессе создания и выполнения проекта "MyApp".
3. Нажмите кнопку "Add Project JAR Files".
4. Разверните узел "Libraries". Архив JAR проекта "MyLib" добавлен в путь к классам проекта "MyApp".

Создание пакета Java и файла класса

1. Щелкните правой кнопкой мыши узел проекта "MyLib" и выберите "New > Java Class". Введите имя нового класса LibClass, затем введите org.me.mylib в поле "Package" и нажмите кнопку "Finish". В редакторе исходного кода откроется LibClass.java.
2. В LibClass.java установите курсор на строке после объявления класса (public class LibClass {).
3. Введите или вставьте следующий код метода:

    public static String acrostic(String[] args) {
        StringBuffer b = new StringBuffer();
        for (int i = 0; i < args.length; i++) {
            if (args[i].length() > i) {
                b.append(args[i].charAt(i));
            } else {
                b.append('?');
            }
        }
        return b.toString();
            }

4. Если вставленный код отформатирован неправильно, нажмите комбинацию клавиш Alt-Shift-F для переформатирования всего файла.
5. Для сохранения файла нажмите комбинацию клавиш Ctrl-S.

Изменение файла Java

Теперь добавим код в Main.java. При этом воспользуемся функциями автозавершения кода и шаблона кода (сокращения), предусмотренными в редакторе исходного кода.

1. Выберите вкладку Main.java в редакторе исходного кода. Если он еще не открыт, разверните узел "MyApp > Source Packages > acrostic" в окне "Projects" и дважды щелкните Main.java.
2. Удалите комментарий // TODO code application logic here в методе main.
3. Вместо этого комментария введите следующее:

   String result = Li

   Установите курсор сразу же после Li. Теперь можно воспользоваться функцией автозавершения кода для подстановки LibClass вместо Li.

4. Нажмите комбинацию клавиш Ctrl-Space для вызова поля автозавершения кода.

   Появится небольшой список допустимых подстановок. Однако требуемого класса LibClass там может не оказаться.

5. Для просмотра расширенного списка возможных соответствий еще раз нажмите комбинацию клавиш Ctrl-Space.

   Класс LibClass должен находиться в этом списке.

6. Выберите LibClass и нажмите клавишу Enter. Оставшаяся часть имени класса будет автоматически подставлена в код средой IDE; кроме того, для этого класса также автоматически создается оператор импорта.

   Примечание: Над полем автозавершения кода также имеется поле с информацией Javadoc по выбранному классу или пакету. Поскольку для большинства пакетов информация Javadoc отсутствует, в этом поле отображается сообщение "Cannot find Javadoc message", пока не будет выбран один из классов Java.

7. В методе "main" введите точку после LibClass. Снова появится поле автозавершения кода.
8. Выберите метод acrostic(String[]args) и нажмите клавишу Enter. После автоматического заполнения метода acrostic появится выделенный параметр args.
9. Нажмите клавишу Enter для подтверждения параметра args.
10. Введите точку с запятой.

    Последняя строка должна выглядеть следующим образом:

    String result = LibClass.acrostic(args);

11. Нажмите клавишу Enter для вставки новой строки. Затем введите sout и нажмите клавишу Tab. Сокращение sout расширяется до System.out.println(""); , а курсор устанавливается между кавычками. Введите Result = в кавычках и + result после закрывающей кавычки. Последняя строка должна выглядеть следующим образом:

    System.out.println("Result = " + result);

12. Для сохранения файла нажмите комбинацию клавиш Ctrl-S.

Установка главного класса и аргументов выполнения

Выходные данные программы зависят от аргументов, передаваемых при выполнении программы. В качестве аргументов будет использоваться пять слов, на основе которых будет создан акростих "Hello".

1. Щелкните правой кнопкой мыши узел проекта "MyApp", выберите "Properties", а затем выберите узел "Run" в левой области диалогового окна. Обратите внимание, что в качестве главного класса уже выбран acrostic.Main.
2. Введите However we all feel zealous в поле "Arguments" и нажмите кнопку "OK".

Выполнение главного проекта

1. Выберите "Run > Run Main Project" (F6) в меню "Run".
2. Дважды щелкните окно "Output" для его увеличения, чтобы были видны все результаты. Учтите, что Ant сначала создает файл MyLib.jar, а затем с его помощью компилирует проект "MyApp". После этого распечатывается вывод программы Result = Hello (акростих фразы, переданной программе в качестве аргумента).
3. Выберите окно "Files" и разверните папку проекта "MyApp". Собранные файлы классов находятся в папке build.
4. Нажмите клавишу F6 для повторного выполнения программы. Компиляция больше не требуется, и программа выполняется нормально.

Очистка и сборка проекта

В случае изменения классов после сборки проекта целесообразно удалить из системы все результаты предыдущей сборки и собрать приложение заново. Для этого используется команда "Clean and Build".

1. Выберите "Build > Clean and Build Main Project" (Shift-F11). После этого будет проведена очистка и повторная сборка проектов "MyLib" и "MyApp".
2. Щелкните правой кнопкой мыши узел проекта "MyLib" в окне "Projects" и выберите "Clean". В этом случае очистка будет выполнена только для проекта "MyLib".

Сборка отдельного проекта

1. Щелкните правой кнопкой мыши узел проекта "MyLib" в окне "Projects".
2. Выберите "Build" в контекстном меню.

Создание документации Javadoc

1. Выберите проект "MyLib".
2. Выберите "Build > Generate Javadoc" для проекта "MyLib" в главном меню среды IDE.

   Результаты создания документации Javadoc отображаются в окне "Output", а сама документация выводится в веб-обозревателе.

Создание тестов JUnit

1. Щелкните правой кнопкой мыши узел LibClass.java в окне "Projects" и выберите "Tools > Create JUnit Tests" (Ctrl-Shift-U).

   Если тесты JUnit в среде IDE создаются впервые, появится диалоговое окно выбора версии "Select JUnit Version". Нажмите клавишу Enter для выбора JUnit 4.x и перейдите (кнопка "Continue") к диалоговому окну "Create Tests".

2. В диалоговом окне "Create Tests" нажмите кнопку "OK" для выполнения команды с параметрами по умолчанию. Средой IDE будет автоматически создан пакет org.me.mylib и файл LibClassTest.java в отдельной папке test. Этот файл можно просмотреть путем раскрытия узла "Test Packages" и в нем подузла org.me.mylib.
3. В LibClassTest.java удалите тело метода public void acrostic().
4. Вместо удаленных строк введите или вставьте следующее:

   System.err.println("Running testAcrostic...");
   String result = LibClass.acrostic(new String[]
                     {"fnord", "polly", "tropism"});
               assertEquals("Correct value", "foo", result);

5. Сохраните файл путем нажатия Ctrl-S.

Выполнение тестов JUnit

1. Выберите узел проекта "MyLib", а затем выберите "Run > Test "MyLib" (Alt-F6). В окне "Output" откроется вкладка MyLib (test). После этого производится компиляция и выполнение тестов JUnit. Результат тестирования JUnit показывает, что тест пройден.
2. Вместо тестирования целого проекта можно также запустить отдельный файл теста. Выберите вкладку LibClass.java в редакторе исходного кода, а затем выберите "Run > Run File  > Test "LibClass.java" в меню "Run".

В среде IDE доступна документация по API JUnit. Для перехода к этой документации выберите "Help > Javadoc References > JUnit API".

Для получения дополнительных сведений о платформе JUnit см. http://www.junit.org.

Отладка проекта

1. В файле LibClass.java перейдите к методу acrostic и установите курсор в любом месте внутри b.append(args[i].charAt(i));. Затем нажмите комбинацию клавиш Ctrl-F8 для создания точки останова.
2. Выберите "Run > Debug Main Project" (Ctrl-F5). IDE открывает окна отладки и выполняет проект в отладчике до достижения установленной точки останова.
3. Откройте окно "Local Variables" и выберите узел args. Массив строк содержит фразу, введенную в качестве аргументов команды.
4. Нажмите кнопку "Step Into" (F7) на панели инструментов для последовательного выполнения фрагментов программы и проверки процесса составления акростиха.

   После завершения программы окна отладки закрываются.