Интегрированная среда разработки NetBeans 4.0 -- это важный шаг вперёд в жизни продукта. Введение новой системы проектов на основе Ant даёт вам лучшее средство управления путём к классам, более разнообразные возможности сборки и выполнения и лучшую интеграцию Ant среди всех сред разработки на рынке. Оно также представляет главное изменение использования среды для тех пользователей, которые привыкли к системе "монтирования" NetBeans 3.6.
Данное руководство разработано для того, чтобы помочь вам перенести ваши приложения и настройки интегрированной среды из среды NetBeans 3.6 в NetBeans 4.0, и чтобы показать вам, насколько более продуктивными вы можете стать с помощью новой системы проектов NetBeans.
В NetBeans 4.0 абсолютно новая система проектов, полностью основанная на Apache Ant. Система проектов NetBeans использует скрипты Ant для компиляции, выполнения, отладки и тестирования ваших приложений и для хранения всех метаданных о проекте.
Вам не нужно быть экспертом в Ant или даже знать, как его использовать, для работы с проектами в NetBeans. Среда предоставляет набор стандартных шаблонов проектов, которые содержат всё необходимое для разработки ваших приложений. Вы можете настроить все основные параметры компиляции и выполнения в интерфейсе проектов.
Опытные пользователи Ant могут использовать всю мощь Ant для настройки процесса сборки. Вы можете расширить стандартный скрипт переопределив цели Ant. Интегрированная среда также содержит набор шаблонов проектов свободной формы, которые позволяют управлять выполнением и компиляцией проекта с помощью вашего собственного скрипта Ant.
В интегрированной среде NetBeans 4.0 вы создаёте стандартный проект для каждого корня ваших исходных файлов и устанавливаете зависимости между проектами. В каждом проекте у вас есть отдельный путь к классам для компиляции, выполнения и тестирования вашего приложения. Если вы использете ваш собственный скрипт Ant для сборки и выполнения проекта, вы можете создать проект свободной формы с несколькими корнями исходных файлов с отдельными путями к классам для каждого корня.
Следующая таблица рассматривает несколько наиболее заметных различий между NetBeans 3.6 и 4.0:
Интегрированная среда NetBeans 4.0
Интегрированная среда NetBeans 3.6
Папки с исходными файлами
Каждый проект может содержать несколько папок с исходными файлами Java.
Каждый стандартный проект может содержать только одну папку с исходными файлами Java (и, для проектов клиентских приложений J2SE, одну папку с тестами JUnit).
Проекты свободной формы могут содержать несколько папок с исходными файлами, но скрипт Ant должен знать о них и соответственно обрабатывать их пути к классам.
Путь к классам
Есть только один путь к классам. Путь к классам состоит из всех папок, добавленных в окне Файлсистемы проводника.
У каждого стандартного проекта есть один путь к классам проекта, но вы можете настроить различные версии пути к классам для тестирования, выполнения и отладки.
Путь к классам для проектов свободной формы управляется скриптом Ant и может быть сколь угодно сложным.
Доступ к файлам и проектам
Вы должны добавить (примонтировать) все папки, к которым вы хотите получить доступ. Окно файлсистем предоставляет основанный на папках доступ к содержимому ваших исходных файлов. Вы можете вынести отдельные файлы и папки в окно Проекты.
Окно Проекты предоставляет логическую организацию ваших исходных файлов Java и веб-приложений. Исходные файлы группируются по пакетам под узом Исходные файлы. Окно Файлы показывает физическое расположение внутри папки проекта на диске. Вы можете получить доступ к любой папке на вашем компьютере с помощью окна Избранное.
Сборка выходного файла
Вы создаёте "рецепт" архива JAR или WAR в окне файлсистем и используете его свойства и контекстное меню для создания архива JAR или WAR.
Файл JAR создаётся каждый раз при сборке стандартного проекта J2SE. Архив WAR создаётся каждый раз при сборке веб-проекта. Вы устанавливаете параметры фильтрования и сжатия на странице Создание архива JAR диалога Свойства проекта для проектов J2SE или на странице Упаковка проекта диалога Свойства проекта для веб-проектов. Стандартные проекты J2SE и веб-проекты создают по одному архиву на проект.
В проектах свободной формы создание результирующих файлов управляется скриптом Ant, и поэтому (как вы уже догадались) может быть сколь угодно сложным.
Совместное использование проектов
Вы не можете совместно использовать проекты или настройки проектов.
Все метаданные проекта располагаются в папке проекта, в форме скриптов Ant, файлов свойств Ant и нескольких файлов XML. Вы можете помещать эти метаданные в систему управления версиями и указывать некоторые параметры, как относящиеся только к вашей установке.
Настройка параметров
Все настройки располагаются в окне Параметры. Вы управляете настройками выполнения, отладки и компиляции используя типы сервисов, присваиваемые проекту или индивидуальным файлам.
Все настройки проекта, такие как путь к классам, настройки компиляции и аргументы командной строки, находятся в диалоге Свойства проекта. Вы можете производить тонкую настройку редактируя скрипт сборки и файл свойств Ant проекта.
Глобальные настройки интегрированной среды, такие как раскраска синтаксиса, настройки веб-браузера и системные параметры, располагаются в окне Параметры.
Веб-приложения
Вы должны добавить (примонтировать) все папки, к которым вы хотите получить доступ. Окно файлсистем предоставляет основанный на папках доступ к содержимому ваших исходных файлов. Вы можете вынести отдельные файлы и папки в окно Проекты. Поддерживаются спецификации JSP 1.2 и 2.0 и страницы JSP не компилируются, а только валидируются средой. Вместе с NetBeans 3.6 поставляется интегрированный сервер Tomcat 5.0.19.
Как и проекты J2SE, веб-проекты разрабатываются с помощью новой системы проектов, которая использует Ant. Веб-проекты могут использовать исходные файлы из нескольких папок, такие как веб-классы вне WEB-INF/classes и библиотеки вне WEB-INF/lib. Если веб-проект зависит от библиотеки классов Java, эта библиотека должна быть представлена отдельным проектом. Расширена поддержка спецификации JSP 2.0, доступны мастера для обработчиков тегов и файлов тегов, а также дополнение кода для описателей библиотеки тегов. Повторно введена компиляция JSP, теперь обрабатываемая Ant. Вместе с NetBeans 4.0 поставляется интегрированный сервер Tomcat 5.0.27.
Стандартные проекты против проектов свободной формы
Следующая таблица описывает основные различия сежду стандартными проектами и проектами свободной формы в NetBeans 4.0:
Стандартные проекты
Проекты свободной формы
Интегрированная среда использует созданный NetBeans скрипт Ant для сборки, выполнения, очистки, тестирования и отладки вашего приложения.
Интегрированная среда использует цели существующего скрипта Ant для сборки, выполнения, очистки, компиляции, тестирования и отладки вашего приложения. Если скрипт Ant не содержит целей для некоторых из этих функций, соответствующие команды будут недоступны. Вы можете написать цели, реализующие данные функции, в вашем скрипте Ant или в дополнительном скрипте.
Каждый проект может содержать только одну папку с исходными файлами и, для настольных приложений, одной папки с тестами. Для использования нескольких папок с исходными файлами создайте по отдельному проекту для каждой папки с исходными файлами и настройте зависимости между проектами.
Каждый проект может содержать произвольное колличество папок с исходными файлами, которые можно добавлять и удалять после создания проекта. Также можно настраивать зависимости от других проектов NetBeans.
Путь к классам проекта управляется настройками на странице Компиляция исходников диалога Свойства проекта. Любые изменения сразу же отображаются в созданном средой скрипте Ant.
Путь к классам проекта управляется вашим скриптом Ant. Настройки пути к классам на странице Путь к классам в диалоге Свойства проекта всего лишь сообщают интегрированной среде, какие классы необходимо использовать для дополнения и реорганизации кода. Когда вы изменяете настройки пути к классам в скрипте Ant, вам необходимо вручную обновить эти настройки в свойствах проекта.
Сборка настраивается с помощью установки базовых свойств в диалоге Свойства проекта или путем переопределения целей в созданном NetBeans скрипте Ant.
Все параметры компиляции и выполнения устанавливаются в скрипте Ant.
Интегрированная среда создаёт один архив JAR (для настольных приложений под J2SE) или архив WAR (для веб-проектов) для всего проекта.
Интегрированная среда создаёт столько продуктов сборки, сколько указано в скрипте Ant проекта.
Из-за того, что структура проектов NetBeans 4.0 так сильно отличается от предыдущих версий, автоматический импорт проектов NetBeans 3.6 не реализован. (Т.к. в NetBeans 3.6 вам необходимо было дабавить одну и ту же папку несколько раз для доступа ко всем необходимым ресурсам приложения, интегрированная среда не сможет сказать, а какая именно из точек монтирования является папкой с исходными файлами).
Для импорта исходного кода, над которым вы работали в версии 3.6, создайте новый проект для каждого корня исходных файлов (или, если у вас есть собственный скрипт Ant, один проект свободной формы для всего приложения). Дополнительная информация об импорте исходного кода в NetBeans 4.0 находится в следующих документах:
Хотя ваши примонтированные папки и связанные с ними настройки и не могут быть импортированы из NetBeans 3.6, большинство общих настроек интегрированной среды импортируются при первом запуске NetBeans 4.0. Настройки версий более ранних чем 3.6 не могут быть импортированы.
Следующие настройки импортируются из NetBeans 3.6:
Следующая страница поясняет как выполнять обычные задачи проекта в NetBeans 4.0:
Для выполения данной задачи
Следуйте этим инструкциям
Создать стандартный проект из существующих исходных файлов.
Выберите Файл > Создать проект (Ctrl-Shift-N).
Выберите Веб > Веб-проект с существующими исходными файлами или Обычные > Проект Java с существующими исходными файлами.
Следуйте дальнейшим инструкциям мастера.
Создать проект свободной формы из существующих исходных файлов и скрипта Ant.
Выберите Файл > Создать проект (Ctrl-Shift-N).
Выберите Веб > Веб-проект с существующим скриптом Ant или Обычные > Проект Java с существующим скриптом Ant.
Следуйте дальнейшим инструкциям мастера.
Добавить архив JAR в путь к классам проекта.
В окне Проекты щёлкните правой кнопкой мыши по узлу проекта и выберите Свойства.
Нажмите Компиляция исходников.
Нажмите Добавить архив/папку и выберите архив JAR в диалоге выбора файлов.
Создать зависимости между проектами.
В окне Проекты щёлкните правой кнопкой мыши по узлу проекта и выберите Свойства.
Нажмите Компиляция исходников.
Нажмите Добавить проект и выберите папку проекта, который вы хотите добавить к пути к классам. Примечание: Для проектов свободной формы добавляйте только результирующие архивы JAR проекта к пути к классам.
Добавить документацию Javadoc и исходный код для архивов JAR по пути к классам.
Выберите Сервис > Менеджер библиотек в главном меню.
Если архив JAR ещё не зарегистрирован в менеджере библиотек, создайте новую библиотеку с помощью кнопки Добавить библиотеку.
Выберите библиотеку в левой панели менеджера библиотек.
На вкладке Путь к классам нажмите Добавить архив/папку и укажите расположение архива JAR, содержащего файлы скомпилированных классов. Библиотека может содержать несколько архивов JAR.
Используйте вкладки Исходные файлы и Документация для добавления папок или архивов, содержащих исходный код и документацию библиотеки.
Нажмите OK для выхода из менеджера библиотек.
Если архив JAR ещё не находится в пути к классам вашего проекта, добавьте его как описано выше.
Установить главный класс проекта, аргументы командной строки, рабочую папку и параметры виртуальной машины.
В окне Проекты щёлкните правой кнопкой мыши по узлу проекта и выберите Свойства.
Нажмите Выполнение проекта и введите соответствующую информацию.
Настроить шаги сборки.
В окне Файлы раскройте папку вашего проекта и откройте файлы nbproject/build-impl.xml и nbproject/project.properties. Файл build-impl.xml содержит все инструкции по обработке вашего проекта. Не изменяйте этот файл, так как он будет перезаписан интегрированной средой.
Найдите нужные цели и свойства, которые управляют тем шагом компиляции, который вы хотите изменить. Каждая из основных целей сборки имеет цели с префиксами -pre и -post, которые вы можете переопределить для добавления инструкций до и после выполнения основной цели.
Дважды щёлкните по файлу build.xml в папке вашего проекта и переопределите любые цели из build-impl.xml.
Измените любое свойство в файле project.properties. Если вы используете проект вместе с другими разработчиками и не хотите, чтобы у них появились ваши изменения, переопределите их в nbproject/private/private.properties.
Установить папку вывода результатов сборки.
В окне Файлы раскройте узел nbproject в папке вашего проекта.
Дважды щёлкните по файлу project.properties чтобы открыть его в редакторе.
Установите папку вывода результатов компиляции в свойстве build.dir. Если вы установите папку вывода вне папки проекта, к ней нельзя будет обратиться из окна Файлы. Примечание: Папка вывода результатов сборки удаляется каждый раз при очистке проекта. Поэтому не стоит устанавливать её указывающей на папку исходных файлов.
