Проекты

В среде IDE пользователь всегда работает в рамках какого-либо проекта. Кроме исходных файлов в проекте IDE также содержатся метаданные о компонентах пути к классам, методах построения и выполнения проекта и т.д. В среде IDE данные проекта сохраняются в папке проекта, в которой содержатся сценарий построения Ant и файл свойств, управляющий параметрами построения и выполнения, а также файл project.xml, отображающий целевые элементы Ant относительно команд IDE.

Примечание. Несмотря на то, что в среде IDE каталоги исходных файлов по умолчанию сохраняются в папке проекта, хранение каталогов исходных файлов в этой папке не является обязательным условием.

Ant

Apache Ant является средством построения на основе технологии Java, используемым для стандартизации и автоматизации сред построения и выполнения для разработки проектов. Система проектов IDE построена непосредственно на базе Ant. Все команды проекта, например "Очистить и построить проект" или "Отладка", вызывают целевые элементы сценария Ant в проекте. Таким образом, возможно одинаковое построение и выполнение проектов как вне среды IDE, так и в ее рамках.

Для работы со средой IDE не требуется наличие знаний о средстве Ant. Можно установить базовые параметры компиляции и выполнения в диалоговом окне "Свойства проекта", и в среде IDE будет выполнено автоматическое обновление сценария проекта Ant. При наличии опыта работы с Ant можно выполнить индивидуальную настройку стандартного сценария проекта Ant или написать собственный сценарий Ant для проекта.

Импорт рабочей области Eclipse

При работе с проектами Eclipse можно использовать мастер импорта проектов Eclipse для создания проектов NetBeans из проектов рабочей области Eclipse и импорта путей к классам и других параметров проекта. При использовании мастера импорта проектов Eclipse создание и настройка проекта NetBeans вручную не требуется. Откройте мастер импорта, выбрав "Файл" > "Импортировать проект" > "Проект Eclipse". См. "Импорт проекта Eclipse в среду IDE NetBeans" для получения информации о работе мастера и способу одновременной работы в проектах Eclipse и NetBeans.

Настройка проекта Java на основе существующих исходных файлов

Для других проектов Java, разработанных вне среды NetBeans, рекомендуется использовать шаблон "Существующие исходники" в мастере создания проектов для построения проекта NetBeans. В мастере необходимо указать путь к исходным файлам и определить папку для метаданных проекта NetBeans. Для настройки проекта используйте диалоговое окно "Свойства проекта".

Настройка проекта NetBeans для существующего проекта Java

1. Выберите Файл > Создать проект (CTRL+SHIFT+N в системе Windows/CMD+SHIFT+N в системе Mac OS).
2. Выберите Java > "Проекты Java с существующими исходными файлами". Нажмите кнопку "Далее".
3. На странице мастера "Имя и местоположение" выполните следующие действия.
   • Введите имя проекта.
   • Измените значение местоположения папки проекта (необязательно).
   • Измените имя сценария построения, используемого в IDE (необязательно). Это может потребоваться, если сценарий построения с именем build.xml, используемый для создания исходных файлов, уже существует.
   • Установите флажок "Использовать отдельную папку для хранения библиотек" и укажите местоположение папки библиотек (необязательно). Для получения дополнительных сведений об этой возможности обратитесь к разделу Совместное использование библиотек проекта.
   • Установите флажок "Установить как главный проект" (необязательно). При выборе этого параметра сочетания клавиш для команд, такие как "Очистить и построить главный проект" (SHIFT+F11), будут применимы к этому проекту.
4. Нажмите кнопку "Далее" для перехода к странице мастера "Существующие исходники".
5. На панели папки с пакетами исходных файлов нажмите "Добавить папку". Далее откройте путь к исходным файлам и, выбрав корневую папку с исходными файлами, нажмите "Открыть".

   Добавляемая папка с исходным кодом должна содержать папку самого высокого уровня иерархии в дереве пакетов. Например, для пакета com.mycompany.myapp.ui необходимо добавить папку, содержащую папку com.

6. (Необязательно) На панели "Папки с тестами" нажмите элемент "Добавить папку" для выбора папки, содержащей папки с пакетом JUnit.
7. Нажмите "Следующий", чтобы перейти к странице мастера "Включить/исключить".
8. (Необязательно) На странице мастера "Включаемые и исключаемые файлы" введите шаблоны имен файлов для всех исключаемых из проекта и включаемых в него файлов. По умолчанию в корневой каталог исходных файлов включены все файлы.
9. Нажмите кнопку "Готово".

Настройка веб-проекта на основе существующих исходных файлов

Для веб-проектов, разработанных вне среды NetBeans, рекомендуется использовать шаблон "Существующие исходники" в мастере создания проектов для построения проекта NetBeans. В мастере необходимо указать путь к исходным файлам и определить папку для метаданных проекта NetBeans. Для настройки проекта используйте диалоговое окно "Свойства проекта".

Примечание. Если проект был первоначально создан в Eclipse, можно сэкономить время, используя мастер импорта проекта Eclipse вместо мастера создания проекта. Мастер импорта проекта Eclipse позволяет импортировать несколько проектов одновременно, включая их параметры настройки. Импорт проектов Eclipse в среду IDE NetBeans.

Настройка проекта NetBeans для существующего веб-приложения

1. Выберите Файл > Создать проект (CTRL+SHIFT+N в системе Windows/CMD+SHIFT+N в системе Mac OS).
2. Выберите Java Web > "Веб-приложения с существующими исходниками". Нажмите кнопку "Далее".
3. На странице мастера "Имя и местоположение" выполните следующие действия.
   • В поле "Расположение" введите имя папки, содержащей корневые папки исходных файлов веб-приложения и папки веб-страниц.
   • Введите имя проекта.
   • (Необязательно) Измените значение местоположения папки проекта.
4. (Необязательно) Установите флажок "Использовать отдельную папку для хранения библиотек" и укажите местоположение папки библиотек. См. раздел Совместное использование библиотек проекта в среде IDE NetBeans для получения дополнительных сведений об этой функциональной возможности.
5. (Необязательно) Выберите флажок "Установить как главный проект". При выборе этого параметра сочетания клавиш для команд, такие как "Очистить и построить главный проект" (SHIFT+F11), будут применимы к этому проекту.
6. Нажмите кнопку "Далее" для перехода к странице мастера "Сервер и настройки".
7. (Необязательно) Добавьте проект в существующее приложение уровня предприятия.
8. Выберите сервер для развертывания. Если требуемый сервер не отображается, нажмите элемент "Добавить" для регистрации сервера в среде IDE.
9. Установите уровень языка на версию Java для выполнения приложения.
10. (Необязательно) Скорректируйте значение контекстного пути. По умолчанию значение контекстного пути базируется на имени проекта.
11. Нажмите кнопку "Далее" для перехода к странице мастера "Существующие исходники и библиотеки".
12. Проверьте все поля страницы, в том числе значения полей "Папка веб-страниц" и "Папки пакета исходных файлов".
13. Нажмите кнопку "Готово".

Проекты свободной формы

Для проектов свободного формата также существуют шаблоны. В проектах свободного формата среда IDE использует целевые элементы существующего сценария Ant для построения, выполнения, очистки, тестирования и отладки приложения. Если сценарий Ant не содержит целевых элементов для этих функций, они будут недоступны для проекта. Для реализации этих функций запишите целевые элементы в сценарии Ant или во вторичном сценарии Ant.

При этом рекомендуется использовать стандартные шаблоны проекта "С существующими исходными файлами" для импорта проекта. Для проектов Eclipse предлагается использовать функцию импорта проекта, посредством которой выполняется создание и настройка стандартного проекта. Стандартные проекты удобнее в управлении при расчете на длительный промежуток времени. Тем не менее, шаблоны проектов свободного формата можно использовать для проектов на базе приложения Ant с комплексными или уникальными параметрами настройки, которые невозможно воспроизвести в рамках стандартного проекта. Например, при импорте проекта, содержащего несколько корневых каталогов исходных файлов с разными путями к классам, без возможности распределения корневых каталогов по различным проектам можно использовать шаблон проекта свободного формата.

Это руководство посвящено, в основном, работе со стандартными проектами. Чтобы получить более подробную информацию о настройке проектов свободной формы, см. раздел "Дополнительная настройка проектов свободной формы".

Настройка основного проекта

При разработке крупномасштабных приложений, содержащих несколько папок с исходными файлами, рекомендуется разделить код на отдельные проекты. Обычно один из таких проектов служит точкой входа для приложения. Для определения в среде IDE, какой из проектов является главной точкой входа для приложения, необходимо установить один из проектов как главный. Среда IDE предоставляет команды, применимые к главному проекту. Например, выполнение команды "Очистить и построить главный проект" приводит к построению главного проекта, а также всех необходимых нижестоящих проектов.

Определение проекта в качестве главного

• Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Установить как главный проект".

Только один проект может быть определен как главный.

Установка целевого пакета JDK в проекте

В среде IDE существует возможность регистрации нескольких платформ Java, а также возможность присоединения документации Javadoc и исходного кода к каждой платформе. При переходе к целевому пакету JDK для стандартного проекта открывается доступ к следующим возможностям:

• предоставление новых классов целевого пакета JDK для автозавершения кода;
• возможное отображение исходного кода целевого пакета JDK и документации Javadoc;
• использование исполняемых программ пакета JDK (javac и java) для компиляции и выполнения приложения;
• компиляция исходного кода с учетом библиотек целевого пакета JDK.

По умолчанию в среде IDE используется версия платформы Java SE (JDK), выполняемая средой как стандартная платформа Java для проектов IDE. Чтобы увидеть версию пакета JDK среды IDE, необходимо выбрать "Справка" > "О программе". Версия пакета JDK выведена в поле "Java".

Выполнение среды IDE при работе с другой версией пакета JDK:

• Запустите среду IDE из командной строки со следующим переключателем:

  --jdkhome jdk-home-dir

  Также можно определить пакет JDK в файле /etc/netbeans.conf, расположенном в папке установки среды IDE.

Регистрация новой платформы Java

1. Выберите "Сервис" > "Платформа Java" из главного меню.
2. Укажите папку, содержащую платформу Java, а также исходные файлы и документацию Javadoc для отладки.

Переход к целевому пакету JDK стандартного проекта

1. Правой кнопкой мыши щелкните узел проекта и выберите элемент "Свойства".
2. Выберите панель "Библиотеки".
3. Измените свойство платформы Java.

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

Добавление группы файлов с классами в путь к классам проекта предоставляет среде IDE данные о возможности доступа проекта к классам во время компиляции и выполнения. Среда IDE также использует настройки пути к классам для активации автозавершения кода, автоматической подсветки ошибок компиляции и реорганизации кода. Объявления пути к классам существующего проекта можно изменить в диалоговом окне "Свойства проекта".

В стандартных проектах Java среда IDE выполняет ведение отдельных путей к классам для компиляции и выполнения проекта, а также компиляции и выполнения тестов JUnit (для приложений Java SE). В среде IDE выполняется автоматическое добавление всех элементов пути к классам компиляции проекта к текущему пути к классам выполнения.

Путь к классам проекта можно изменить, выполнив действия, описываемые ниже.

• Щелкните правой кнопкой мыши узел проекта, выберите "Свойства", затем - категорию "Библиотеки" и измените отображаемые записи пути к классам.
• Щелкните правой кнопкой мыши узел "Библиотеки" в окне "Проекты" и выберите команды "Добавить проект", "Добавить библиотеку" или "Добавить архив JAR/папку".

При присоединении документации Javadoc и исходных файлов к файлу JAR в диспетчере библиотек среда IDE автоматически добавит их в проект в случае регистрации файла JAR в пути к классам проекта. Можно перейти к классам и найти страницы Javadoc для классов, не выполняя настройку.

Управление зависимостями между проектами

Если приложение состоит из нескольких проектов, необходимо настроить зависимости пути к классам между проектами. Как правило, выполняется одновременная настройка главного проекта, содержащего главный класс (в проектах Java SE) и нескольких обязательных проектов. Под обязательным проектом подразумевается проект, который был добавлен в путь к классам другого проекта. При очистке и построении проекта среда IDE выполняет эти действия и для обязательных проектов. Документация Javadoc и исходные файлы обязательного проекта также доступны для принимающего проекта.

Можно добавить обязательные проекты в собственный проект, щелкнув правой кнопкой мыши узел "Библиотеки" в окне "Проекты" или указав их на вкладке "Библиотеки" в диалоговом окне "Свойства проекта". Для добавления обязательного проекта выберите папку проекта, файлы JAR которого необходимо добавить в путь к классам (окно выбора файлов отображает значки папок проекта IDE (). При добавлении проектов в окне "Свойства проекта" убедитесь в том, что флажок "Собирать проекты по пути к классам" установлен.

Для добавления проекта свободного формата в путь к классам стандартного проекта необходимо добавить файл JAR проекта свободного формата. Для выполнения этого действия необходимо сначала объявить все выходные файлы проекта свободного формата на панели "Вывод" диалогового окна "Свойства проекта".

Совместное использование библиотек проекта

Поскольку система проектов среды IDE NetBeans основана на сценариях Ant, как правило, проекты NetBeans могут использоваться различными пользователями, вне зависимости от того, работают ли они в среде IDE. Тем не менее, по умолчанию способ создания ссылок сценария построения проекта на библиотеки зависит от параметров, определенных для каждого пользователя, в частности, в случае ссылок на библиотеки, определенных в диалоговом окне "Диспетчер библиотек".

Например, можно упаковать проект в файл zip и передать другому пользователю, который сможет распаковать его и запустить. Однако если проект зависит от пользовательской библиотеки, определенной в диалоговом окне "Диспетчер библиотек", у других пользователей могут возникнуть трудности с построением проекта из-за недействительных ссылок на пользовательскую библиотеку.

Другое возможное неудобство заключается в том, что библиотеки в зависимости от происхождения различаются по местоположению. Библиотеки, поставляемые вместе со средой IDE, сохраняются во время установки среды в множестве различных папок. В качестве примера можно привести библиотеки Swing Layout Extensions, привязки компонентов и драйверы базы данных.

Для решения этой проблемы можно сохранять библиотеки проекта в отдельной папке. Кроме того, при создании ссылок на библиотеки можно использовать относительный или абсолютный путь.

Эти возможности способствуют упрощению решения проблем в ситуациях, описываемых ниже.

• Существует необходимость в открытии доступа к создаваемому проекту и предоставлении возможности построения проекта для других пользователей вне зависимости от того, используют ли они среду IDE. Пользователи должны иметь возможность доступа к проекту посредством выписки из управления версиями или распаковывания полученного архива zip. Построение приложения также должно осуществляться без дополнительных настроек.
• Существует необходимость работы с существующим проектом и придерживаться строго установленных ограничений, касающихся хранения библиотек проекта (а также доступа к ним сценария построения посредством относительных или абсолютных ссылок).

Для стандартных проектов Java SE, Web и Enterprise можно определить отдельную папку с библиотеками. Папку для библиотек можно установить во время создания проекта (в мастере создания проекта) или по завершении создания на вкладке "Библиотеки" диалогового окна "Свойства проекта".

Для настройки совместного использования библиотек по завершении создания проекта, выполните следующие действия.

1. Выберите "Файл" > "Создать проект".
2. В категории "Java" мастера создания проекта выберите один из стандартных шаблонов. Нажмите кнопку "Далее".
3. На странице мастера "Имя и местоположение" установите флажок "Отдельная папка для совместного использования библиотек".
4. В поле папки "Библиотеки" выберите путь для хранения библиотек.

   В случае существования библиотек в среде IDE они будут скопированы в указанную папку.

Настройка библиотек веб-проектов или проектов Java EE для совместного использования по завершении создания проекта

1. Выберите "Файл" > "Создать проект".
2. В категории мастера "Веб" выберите один из стандартных шаблонов. Нажмите кнопку "Далее".
3. На странице мастера "Имя и местоположение" установите флажок "Отдельная папка для совместного использования библиотек".
4. В поле папки "Библиотеки" выберите путь для хранения библиотек.

   В случае существования библиотек в среде IDE они будут скопированы в указанную папку.

Настройка библиотек существующего проекта для совместного использования

1. Правой кнопкой мыши щелкните узел проекта и выберите элемент "Свойства".
2. В диалоговом окне "Свойства проекта" выберите узел "Библиотеки".
3. На панели "Библиотеки" нажмите кнопку "Обзор" для открытия мастера создания папки библиотек.
4. На странице мастера "Папка библиотек" введите местоположения для библиотек и нажмите кнопку "Далее".
   Путь можно указать как относительную или абсолютную ссылку.
5. На панели мастера "Действия" проверьте выбранное действие для каждой библиотеки в списке. В большинстве случаев среда IDE обнаруживает наиболее подходящее действие для выбранной библиотеки.

   Доступны следующие действия:

   • Копирование архивов JAR библиотеки в новую папку библиотек. Рекомендуется использовать этот параметр при отсутствии библиотеки в выбранной папке и необходимости разместить архивы JAR в этой папке.
   • Использование относительного пути к архивам JAR библиотеки. Этот параметр используется при отсутствии библиотеки в папке библиотек и необходимости получения доступа к библиотеке посредством относительного пути к ее текущему местоположению. В файл nblibraries.properties папки библиотек будет добавлена запись с относительной ссылкой.
   • Использование абсолютного пути к архивам JAR библиотеки. Использование этого параметра требуется при отсутствии библиотеки в папке библиотек и необходимости получения доступа к библиотеке посредством абсолютного пути к ее текущему местоположению. В файл nblibraries.properties папки библиотек будет добавлена запись с абсолютной ссылкой.
   • Использование существующей библиотеки в папке библиотек. Рекомендуется использовать этот параметр при существовании копии библиотеки в папке библиотек и необходимости в ее использовании.
6. Нажмите кнопку "Готово" для выхода из мастера настройки совместного использования проекта.
7. Нажмите кнопку "ОК" для выхода из диалогового окна "Свойства проекта".

Примечание. Для перемещения папки библиотек можно также использовать узел "Библиотеки" в диалоговом окне свойства проекта. Если папка для библиотек уже определена, то при нажатии кнопки "Обзор" вместо мастера создания папки библиотек откроется окно выбора файлов.

Обеспечение доступности документации Javadoc в среде IDE

Посмотреть документацию по интерфейсу API JavaSE в среде IDE NetBeans можно с помощью команды "Source" (Источник) > "Документация". Посмотреть документацию в отдельном окне можно с помощью пункта главного меню "Окно" > "Другое" > Javadoc.

Однако для некоторых сторонних библиотек документация по интерфейсу API недоступна. В этом случае ресурсы Javadoc необходимо связать со средой IDE вручную.

Обеспечение доступности документации Javadoc по интерфейсу API через команду "Просмотреть Javadoc":

1. Загрузите источник документации Javadoc по интерфейсу API.
2. Выберите "Tools" > "Библиотеки".
3. В списке "Библиотеки" выберите библиотеку, которая используется для проекта.
4. Выберите вкладку "Javadoc".
5. Нажмите кнопку "Добавить архив ZIP/папку" и перейдите к файлу ZIP или к папке, содержащей документацию Javadoc по интерфейсу API в системе. Выберите файл с ZIP или папку и нажмите кнопку "Добавить архив ZIP/папку".
6. Нажмите кнопку "ОК".

Активация Java Web Start для приложения

Существует возможность настройки приложения для его выполнения посредством Java Web Start в среде IDE. Для этого используется категория "Java Web Start" в окне "Свойства проекта". Для получения дополнительных сведений об активации Java Web Start обратитесь к учебному курсу Активация Java Web Start в среде IDE NetBeans.

Настройка Java Web Start для приложения

1. Правой кнопкой мыши щелкните узел проекта и выберите элемент "Свойства".
2. В диалоговом окне "Свойства проекта" выберите узел "Приложение" > Web Start.
3. Выберите флажок "Активация Web Start" и выполните настройку Java Web Start, следуя рекомендациям раздела Активация Java Web Start в среде IDE NetBeans.

Создание проектов, пакетов и файлов

Среда IDE обеспечивает простое и удобное выполнение компиляции. При условии корректной установки пути к классам компиляции проекта необходимо только выбрать компилируемый проект, пакет или файл и нажать соответствующую команду, "Построить" или "Скомпилировать", в меню "Выполнить". Среда IDE выполнит компиляцию файлов.

В случае включения функции "Компиляция при сохранении" для проекта Java (или функции "Развертывание при сохранении" для проектов Java web или проектов уровня предприятия) среда IDE выполнит автоматическую компиляцию файлов при сохранении. См. следующий раздел Компиляция при сохранениидля получения дополнительных сведений.

Построение приложения для развертывания

• Выберите "Выполнить" > "Clean and Build Project" (Очистить и собрать проект).

  Все ранее скомпилированные файлы и выходные файлы, например архивы JAR, удаляются. Выполняется новая компиляция файлов и создание новых выходных файлов. Для размещения скомпилированных классов создается папка build. Для распределяемых выходных файлов, например архивов JAR или документации Javadoc создается папка dist. Выходные файлы построения можно просмотреть в окне "Файлы".

При каждом вызове команд компиляции среда IDE отображает выходные данные, в частности, ошибки компиляции, в окне "Вывод", как описывается в следующем разделе Исправление ошибок компиляции.

Компиляция при сохранении

Функция компиляции при сохранении среды IDE позволяет сэкономить время при выполнении и отладке проектов IDE. В случае включения данной функции для проекта при сохранении файлов выполняется их компиляция. Скомпилированные файлы сохраняются в кэше, используемом средой IDE при выполнении, тестировании, отладке и профилировании проекта IDE. В результате появляется возможность тестирования и отладки приложения без необходимости ожидания завершения его построения.

При включении функция "Компиляция при сохранении" предоставляет возможности, рассматриваемые ниже.

• Среда IDE выполняет компиляцию файлов при их сохранении, так что проект доступен для выполнения и отладки в среде IDE в любой момент времени.
• Команда "Построить" будет отключена. При необходимости повторного построения архива JAR без использования команды "Очистить и построить" требуется отключить функцию "Компиляция при сохранении".
• Сценарий Ant проекта не используется при выборе команд "Выполнить", "Отладка", "Профиль" или "Тестировать". Настройка сценария построения для использования этих команд будет проигнорирована.
• Архив JAR, созданный в результате построения проекта, не обновляется при сохранении изменений в файлах. Для построения или повторного построения архива JAR необходимо использовать команду "Очистить и построить". Команда "Очистить и построить" всегда использует сценарий Ant проекта вне зависимости от состояния включения функции "Компиляция при сохранении".

Данная функция включается по умолчанию для создаваемых проектов. Для существующих проектов функция компиляции при сохранении отключена.

Включение и отключение компиляции при сохранении для проекта Java

1. Правой кнопкой мыши щелкните узел проекта и выберите элемент "Свойства".
2. Выберите узел "Компиляция" и установите свойство "Компиляция при сохранении".

Кроме того, в среде IDE существует аналогичная функция "Развертывание при сохранении" для веб-приложений Java и приложений уровня предприятия. При включении функции "Развертывание при сохранении" для проекта, развернутого на сервере посредством среды IDE, немедленно выполняется повторное развертывание измененных файлов на сервере. Для корректной работы данной функции на сервере GlassFish V2 необходимо выбрать параметр "Развертывание каталога включено" для экземпляра Glassfish.

Включение или отключение развертывания при сохранении для веб-проектов Java или проектов уровня предприятия

1. Правой кнопкой мыши щелкните узел проекта и выберите элемент "Свойства".
2. Выберите узел "Выполнение" и установите свойство "Развертывание при сохранении".

Включение развертывания каталога на сервере Glassfish V2

1. Выберите элементы "Сервис" > "Серверы".
2. Выберите требуемый сервер.
3. Перейдите на вкладку "Параметры".
4. Выберите параметр "Развертывание каталога включено".

Исправление ошибок компиляции

В среде IDE в окне "Вывод" отображаются выходные сообщения и ошибки компиляции. Это окно с несколькими вкладками выводится при создании записей об ошибках компиляции, отладке программы, создании документации Javadoc и пр. Окно можно также открыть вручную, выбрав "Окно" > "Вывод" (CTRL+4 в системе Windows/Cmd+4 в системе Mac OS).

Также ошибки компиляции выводятся в окне "Задачи" и выделены в редакторе исходного кода.

Одной из важнейших функций окна "Вывод" является уведомление об ошибках, найденных во время компиляции программы. Сообщение об ошибке выводится в виде текста с подчеркиванием синего цвета и связано со строкой исходного кода, вызвавшей возникновение ошибки, как показано на рисунке ниже. Окно "Вывод" также предоставляет ссылки на ошибки, найденные во время выполнения сценариев Ant. При нажатии ссылки на ошибку в окне "Вывод" редактор исходного кода автоматически переходит к строке с ошибкой.

Результат каждого действия, выполняемого посредством сценария Ant, например компиляция, выполнение и отладка файлов, также отображается на вкладке окна "Вывод". Для сохранения сообщений, отображаемых в окне "Вывод", можно скопировать и вставить их в отдельный файл. Также можно настроить сценарий Ant для вывода результата выполнения команды для каждой новой цели в новой вкладке окна "Вывод", нажав элементы "Сервис" > "Параметры", выбрав категорию "Разное", нажав вкладку "Ant" и отменив выбор флажка свойства "Повторное использование вкладок с результатом завершенного процесса".

Фильтрация выходных файлов

При создании архива JAR или файла WAR обычно требуется включить в них скомпилированные файлы .class или другие исходные файлы, расположенные в каталоге исходных файлов, например наборы ресурсов или документы XML. Фильтр по умолчанию выполняет включение всех необходимых файлов и исключает файлы .java, .nbattrs и .form из выходного файла.

Дополнительные фильтры для управления выходными файлами можно создать при помощи регулярных выражений. Для указания исключаемых файлов щелкните правой кнопкой мыши проект а окне "Проекты" и выберите элемент "Свойства" для вывода диалогового окна "Свойства проекта". На левой панели нажмите элемент "Упаковка". В текстовом поле на правой панели введите регулярные выражения для определения исключаемых файлов при упаковке файлов JAR или WAR. Кроме выражений по умолчанию можно использовать дополнительные регулярные выражения, перечисленные ниже.

Регулярное выражение	Описание
\.html$	Исключение всех файлов HTML
\.java$	Исключение всех файлов Java
(\.html$)|(\.java$)	Исключение всех файлов HTML и Java
(Key)|(\.gif$)	Исключение всех файлов GIF и файлов, содержащих в имени компонент Key

Подробные сведения о синтаксисе выражений приведены на сайте jakarta.apache.org.

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

При работе с проектами Java в качестве главного обычно устанавливается проект, содержащий главный класс программы. Для веб-проектов главным является проект, развернутый первым. Для выполнения проекта, пакета или файла выполните одно из действий, перечисленных ниже.

• В главном меню выберите "Выполнить" > "Выполнить главный проект", чтобы выполнить главный проект. Также можно использовать кнопку "Выполнить главный проект" на панели инструментов.
• В окне проектов щёлкните правой кнопкой мыши название проекта и выберите "Выполнить" для выполнения проекта. Обратите внимание, что для проектов Java необходимо наличие главного класса.
• В окне "Проекты" щелкните правой кнопкой мыши файл и выберите команду "Выполнить файл" (SHIFT+F6) для его выполнения. Или в главном меню выберите "Выполнить" > "Выполнить файл" > "Run filename" (Выполнить имя_файла) , чтобы выполнить работоспособный класс.

При выполнении проекта среда IDE выводит все ошибки компиляции и выходные данные в окне "Вывод". Дополнительные сведения приведены в разделе Исправление ошибок компиляции.

Примечание. При включении функции "Компиляция при сохранении" для проекта команда "Выполнить проект" действует для файлов классов, созданных при их сохранении. Сценарий построения Ant не используется. При определении пользовательских действий в сценарии построения вышеописанные действия не выполняются. В случае необходимости выполнения полного процесса построения при использовании команд "Выполнить проект", "Отладка проекта" и "Профилирование проекта" отключите функцию "Компиляция при сохранении".

Настройка параметров выполнения

По умолчанию главный класс, аргументы выполнения и аргументы JVM в среде IDE не определены. Путь к классу выполнения каждого стандартного проекта содержит скомпилированные классы проекта и все элементы пути к классам компиляции проекта. Путь к классам компиляции проекта можно просмотреть, открыв диалоговое окно "Свойства проекта", выбрав узел "Библиотеки" на панели "Категории" и нажав вкладку "Компиляция" на правой панели.

Для изменения параметров выполнения проекта откройте диалоговое окно "Свойства проекта", щелкнув правой кнопкой мыши узел проекта в окне "Проекты" и выбрав элемент "Свойства". Затем выберите узел "Библиотеки" на панели "Категории" и нажмите вкладку "Выполнение" на правой панели диалогового окна. Обратите внимание, что для доступа к параметрам главного класса, аргументов программы, рабочего каталога для выполнения программы и параметров VM необходимо выбрать узел "Выполнение". В следующем разделе будет представлено подробное описание настройки пути к классам выполнения.

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

Для добавления проектов, библиотек, архивов JAR и папок в путь к классам выполнения проекта используйте кнопки, расположенные в правой части списка "Библиотеки времени выполнения" в диалоговом окне "Свойства проекта".

При динамическом использовании специальных библиотек в проекте во время выполнения через интерфейс посредника или интерфейс API отражения (например, посредством драйверов JDBC или реализации JAXP) необходимо добавить эти библиотеки в путь к классам выполнения. Также настройка пути к классам выполнения необходима, если зависимости между проектами не соответствуют зависимостям компиляции между проектами. Допустим, что для проекта A выполняется компиляция относительно проекта B, а для проекта B – относительно проекта C, но для проекта A не выполняется компиляция относительно проекта C. Следовательно, в путь к классам выполнения проекта A будет включен только проект B. Если во время выполнения для проекта A требуются как проект B, так и проект C, необходимо добавить проект C в путь к классам выполнения проекта A.

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

Для установки главного класса проекта выберите узел "Выполнить" на панели "Категории" диалогового окна "Свойства проекта" и введите полное имя в поле "Главный класс" (например, org.myCompany.myLib.MyLibClass). Главный класс должен содержаться в проекте, архивах JAR или библиотеках в пути к классам выполнения проекта. Затем введите необходимые аргументы выполнения в поле "Аргументы".

При использовании кнопки "Обзор" для выбора главного класса проекта средство выбора файлов отображает только классы в каталоге исходных файлов проекта. В случае возникновения необходимости в определении класса в одной из библиотек в пути к классам требуется ввести полное имя класса в поле "Главный класс".

Установка аргументов JVM

Аргументы JVM для проекта можно указать в диалоговом окне "Свойства проекта". Откройте диалоговое окно "Свойства проекта" и нажмите элемент "Выполнить" на панели "Категории", а затем введите список аргументов JVM в поле "Параметры VM", разделяя их пробелами.

Свойства системы можно установить, введя следующее значение в поле "Параметры VM":

-Dname=value

<target name="jar" />

Редактирование и выполнение сценариев Ant

Среда IDE автоматически распознает сценарии Ant и отображает их как узлы сценария Ant () вместо стандартных файлов XML. Можно щелкнуть сценарии Ant правой кнопкой мыши в окне "Проекты", "Файлы" или "Избранное" для доступа к всплывающему меню с командами. Также можно развернуть узел Ant для просмотра подузлов, отображающих целевые элементы сценария Ant в алфавитном порядке. Для каждого подузла также можно вызвать всплывающее меню с командами.

В окнах "Проекты", "Файлы" и "Избранное" подузлы сценария Ant отмечены следующим образом:

Значок	Значение
	Выделенный целевой элемент Ant. Такие целевые элементы включают в себя атрибут описания, отображаемый в качестве подсказки. Атрибут описания целевого элемента можно задать в редакторе исходного кода.
	Стандартный целевой элемент Ant. Целевой элемент без атрибута описания.

Дважды щелкните любой подузел сценария Ant для перехода к строке целевого элемента в редакторе исходного кода. Все стандартные инструменты поиска XML, инструменты выбора и сочетания клавиш доступны при редактировании сценариев Ant, также среда IDE предоставляет функцию автозавершения кода для всех стандартных задач Ant.

При создании целевого элемента, выполняемого из командной строки, задайте для него атрибут описания. При возникновении трудностей с определением имен целевых объектов или их назначения можно выполнить команду -projecthelp <script> из командной строки. При использовании этой команды в Ant будет выведен список всех целевых элементов с атрибутом описания, а также их описание. При наличии нескольких целевых элементов в сценарии построения Ant рекомендуется применять функцию выделения для различия часто используемых элементов от редко используемых.

Стиль шрифта метки подузла в окнах "Проекты", "Файлы" и "Избранное" также указывает на различия целевых элементов.

• Стандартный шрифт. Целевой элемент определен в текущем сценарии Ant.
• Курсив. Целевой элемент импортирован из другого сценария Ant.
• Серый цвет. Внутренний целевой элемент не может быть выполнен напрямую. Внутренним целевым элементам присваиваются имена, начинающиеся с символа "-".
• Жирный. Целевой элемент сценария по умолчанию (в случае существования). Целевой элемент по умолчанию объявляется как атрибут проекта вместе с другими атрибутами проекта, например именем. Атрибут целевого элемента проекта по умолчанию можно задать в редакторе исходного кода.

Целевые элементы, импортируемые из другого сценария, но переопределенные в сценарии импорта, не отображаются в списке. Выводятся только целевые элементы переопределения.

Целевые элементы сценария Ant можно выполнить посредством узла сценария в окне "Проекты", "Файлы" или "Избранное". Щелкните правой кнопкой мыши узел сценария Ant и выберите целевой элемент из подменю "Достигнуть цель". Целевые элементы перечислены в алфавитном порядке. Отображаются только выделенные целевые элементы. Выберите "Другие целевые элементы" для выполнения целевого элемента, не выделенного при помощи атрибута описания. Внутренние целевые элементы исключаются из этих списков в силу невозможности их независимого выполнения.

Вместо всплывающего меню узла сценария Ant для выполнения цели можно использовать команду "Достигнуть цель", доступную при нажатии правой кнопкой мыши узла целевого элемента.

Запись пользовательских задач Ant

Пользовательские задачи Ant можно использовать для развертывания функций, предоставляемой встроенными задачами Ant. Они часто используются для определения свойств, создания вложенных элементов или записи текста непосредственно между тегами посредством метода addText.

Создание пользовательской задачи Ant в среде IDE

1. Щелкните правой кнопкой мыши пакет, в который необходимо поместить задачу, и выберите "Создать" > "Другое".
2. Выберите категорию "Другое" и тип файла "Пользовательская задача Ant".
3. Завершите работу мастера.

При создании файла пользовательской задачи Ant в редакторе исходного кода будет открыт шаблон. В шаблоне содержится пример кода для многих распространенных операций, выполняемых посредством задач Ant. После каждого раздела кода в шаблоне отображаются способы использования задачи в сценарии Ant.