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

Содержание

• Совместное использование проектов
• Настройка местоположения библиотек

Для работы с этим руководством требуется программное обеспечение и ресурсы, перечисленные ниже.

Программное обеспечение или ресурс	Требуемая версия
Среда IDE NetBeans	версия 6.1
Комплект для разработчика на языке Java (JDK)	версия 6 или версия 5

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

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

Однако при этом существенное неудобство заключается в способе создания ссылок сценарием сборки проекта на библиотеки, который зависит от параметров, определенных для каждого пользователя, особенно в случае библиотек, определенных в диалоговом окне "Library Manager".

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

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

В среде IDE NetBeans 6.1 проектная система была усовершенствована и содержит больше вариантов выбора библиотек, которые должны располагаться по пути к классам, установленном в проекте. Такая гибкость необходима в следующих ситуациях:

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

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

Настройка местоположения библиотек

Стандартные проекты приложений для Java SE, веб-приложений и приложений уровня предприятия можно настроить для совместного использования. Настроить проект для совместного использования можно при создании проекта (в мастере создания проекта) или впоследствии на вкладке "Libraries" в диалоговом окне "Project Properties".

Для настройки совместного использования общих библиотек проекта Java при создании проекта:

1. Выберите "File > New Project".
2. В категории "Java" мастера выберите один из стандартных шаблонов. Затем нажмите кнопку "Next".
3. На странице "Name and Location" мастера установите флажок "Use Dedicated Folder for Sharing Libraries".
4. В поле "Libraries" выберите местоположение для сохраняемых библиотек.

   Если какие-то библиотеки уже включены в среду IDE, они будут скопированы в указанную папку.

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

1. Выберите "File > New Project".
2. В категории "Web" мастера выберите один из стандартных шаблонов. Затем нажмите кнопку "Next".
3. На странице "Name and Location" мастера установите флажок "Use Dedicated Folder for Sharing Libraries".
4. В поле "Libraries" выберите местоположение для сохраняемых библиотек.

   Если какие-то библиотеки уже включены в среду IDE, они будут скопированы в указанную папку.

5. (Дополнительно) На странице "Server and Settings" установите переключатель "Copy Server JAR Files to Libraries Folder".

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

1. Щелкните правой кнопкой мыши узел проекта и выберите "Properties".
2. В диалоговом окне "Project Properties" выберите узел "Libraries".
3. На экране "Libraries" нажмите кнопку "Browse" и откройте мастер "New Libraries Folder".
4. На странице "Library Folder" мастера введите местоположение для библиотек и нажмите кнопку "Next".

   В качестве местоположения можно ввести как относительную, так и абсолютную ссылку.

5. На экране "Actions" мастера проверьте выбранное действие для каждой из перечисленных библиотек. В большинстве случаев среда IDE автоматически обнаруживает наиболее подходящее действие для выбранной библиотеки.

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

   • Copy Library JAR Files to New Libraries Folder. Этот вариант используется, если библиотека отсутствует в выбранной папке и архивные файлы JAR необходимо переместить в эту папку.
   • Use Relative Path to Library JAR Files. Этот вариант используется, если библиотека отсутствует в выбранной папке и получать доступ к библиотеке необходимо через относительный путь к существующему местоположению. В файл папки библиотек nblibraries.properties добавляется запись об относительной ссылке.
   • Use Absolute Path to Library JAR Files. Этот вариант используется, если библиотека отсутствует в папке библиотек и получать доступ к библиотеке необходимо через абсолютный путь к существующему местоположению. В файл папки библиотек nblibraries.properties добавляется запись об абсолютной ссылке.
   • Use Existing Library in Libraries Folder. Этот вариант используется, если в папке библиотек уже существует копия библиотеки и необходимо использовать эту копию библиотеки.
6. Нажмите кнопку "Finish" для выхода из мастера "Make Project Sharable".
7. Нажмите кнопку "OK" для закрытия диалогового окна "Project Properties".

Примечания:

• Для изменения местоположения папки библиотек можно также использовать узел "Libraries" в диалоговом окне "Project Properties". Если папка библиотек уже указана, при нажатии "Browse" вместо мастера "New Libraries Folder" открывается средство выбора файлов.
• Библиотеки проекта свободного формата не могут быть настроены для совместного использования описанными в этом разделе способами.
• Мастер создания проекта не отображает настройку совместно используемых библиотек для некоторых стандартных шаблонов проекта, например, настольных приложений на Java. Однако такие проекты можно настроить для совместного использования в диалоговом окне "Project Properties".