Импорт существующего исходного кода Java в среду NetBeans 4.0 Концепции
Сравнение типов проектов
| Стандартный |
Свободной формы |
|
Использует созданный средой скрипт Ant для сборки, выполнения и отладки вашего приложения.
|
Использует цели существующего скрипта Ant для очистки, компиляции, тестирования, выполнения и отладки вашего приложения. Если скрипт Ant не содержит целей для некоторых из этих функций, соответствующие команды будут недоступны в интегрированной среде. Можно затем написать цели, реализующие данные функции. |
|
Каждый проект может содержать только одну папку с исходными файлами и, для настольных приложений, одной папки с тестами. Для использования нескольких папок с исходными файлами создайте по отдельному проекту для каждой папки с исходными файлами и настройте зависимости между проектами.
|
Может содержать произвольное колличество папок с исходными файлами, которые можно добавлять и удалять после создания проекта. Также можно настраивать зависимости от других проектов NetBeans.
|
|
Сборка настраивается с помощью установки базовых свойств в диалоге Свойства проекта или путем переопределения целей в созданном NetBeans скрипте Ant.
|
Все параметры компиляции и выполнения устанавливаются в скрипте Ant. Настройки проекта должны повторять связи содержимого и пути к классам, указанные в скрипте, для нормального функционирования дополнения, реорганизации кода и выделения ошибок. |
|
Интегрированная среда собирает один архив JAR (для настольных приложений под J2SE) или архив WAR (для веб-проектов) для всего проекта.
|
Интегрированная среда создаёт столько продуктов сборки, сколько указано в скрипте Ant проекта. |
|
Интегрированная среда содержит следующие шаблоны стандартных проектов:
- Приложение Java
- Библиотека Java
- Веб-приложение
- Проект Java с существующими исходными файлами
- Веб-проект с существующими исходными файлами
|
Интегрированная среда содержит следующие шаблоны проектов свободной формы:
- Проект Java с существующим скриптом Ant
- Веб-проект с существующим скриптом Ant
|
|
Папки с исходными файлами
При добавлении папки, содержащей исходный код, вы должны добавить папку, которая содержит папку наивысшего уровня в вашей иерархии пакетов например, для пакета com.jcardshark.blackjack.ui необходимо добавить папку, содержащую папку com.
Стандартный
У вас может быть только по одной папке с исходными файлами и одной папке с тестами JUnit в каждом проекте. Для работы с несколькими папками с исходными файлами, создайте по проекту для каждой папки с исходниками и поместите проекты в путь к классам каждого из них по необходимости.
Свободной формы
Проект может содержать несколько папок с исходными файлами и определять сложные зависимости пути к классам между папками. Папки с исходниками могут распологаться где-угодно на диске и могут быть добавлены и удалены после создания проекта.
Папка проекта
Папка проекта содержит скрипт Ant и файлы свойств, которые управляют сборкой и выполнением проекта.
Стандартный
Папка проекта содержит два скрипта Ant:
- nbproject/build-impl.xml содержит инструкции для обработки проекта. Данный файл создаётся интегрированной средой разработки и не должен редактироваться.
- build.xml импортирует цели из build-impl.xml. Его можно редактировать для переопределения существующих целей или создания новых целей.
Папка проекта также содержит папку результатов сборки для скомпилированных классов, архивов JAR (для настольных приложений под J2SE) или архивов WAR (для веб-проектов) и документации Javadoc.
Свободной формы
При указании расположения проекта свободной формы, это расположение не обязательно указывает папку со скриптом Ant. Например, если все ваши пакеты с исходными файлами организованы в одну папку, вы можете установить эту папку для размещения проекта, даже если она не содержит скрипта сборки. Расположения папок с результатами сборки зависит от настроек в вашем скрипте Ant.
Корень веб-модуля
Корень веб-модля - это папка верхнего уровня веб-приложения. В ней находятся страницы JSP, классы и архивы для клиента и такие статические веб-ресурсы как картинки. Нижеприведённый рисунок показывает структуру исходных файлов типичного веб-приложения.
Главный проект
При организации приложения в несколько проектов, главный проект служит точкой входа в приложение. Обычно главный проект содержит главный класс, с которого начинается выполнение приложения. Многие команды меню, такие как Выполнить и Собрать, имеют комбинации клавиш для главного проекта. Доступ к командам для индивидуальных проектов организован с помощью контекстного меню, которое открывается с помощью нажатия правой кнопки мыши по узлу проекта в окне Проекты.
Для того, чтобы сделать проект главным, щёлкните правой кнопкой мыши на узле проекта в окне Проекты и выберите Установить как главный проект.
Связывание команд с целями Ant
Проекты свободной формы опираются на скрипт Ant в плане предоставления целей для всех действий интегрированной среды, включая такие действия:
- Сборка
- Очистка
- Комиляция проекта
- Компиляция одного файла
- Компиляция серверной страницы Java
- Выполнение проекта
- Выполнение одного файла
- Создание документации
- Выполнение тестов JUnit
- Отладка проекта
- Отладка одного файла
- Исправление на лету и продолжение отладки
- Повторное развёртывание веб-проекта
Если скрипт Ant не содержит целей для этих действий, соответствующие команды будут недоступны в интегрированной среде. Вы легко можете написать цели позже и связать их с данными командами в диалоге Свойства проекта.
Если вы не можете изменить скрипт Ant и включить в него новые цели, вы можете написать вторичный скрипт Ant, содержащий эти цели. Дополнительная информация находится на странице Расширенная настройка проекта свободного формата.
Окна Проекты и Файлы
Окно Проекты показывает сгруппированные по пакетам файлы проектов. Вы можете щёлкнуть правой клавишей мыши по узлу проекта для выполнения над проектов каких-либо действий. Настройка свойств производится путём нажатия правой клавишей мыши по узлу проекта и выбора команды Свойства из контекстного меню.
Окно Файлы показывает физическое размещение файлов проекта на диске. Показываются папка проекта и каждая из папок с исходными файлами для каждого проекта. Папка nbproject содержит метаданные о проекте.
Установка пути к классам
Стандартный
При добавлении классов к пути к классам проекта, интегрированная среда делает эти классы доступными для дополнения и реорганизации кода. Можно добавлять следующие типы элементов пути к классам в проект:
- Архив JAR - упакованная библиотека скомпилированных классов Java только для настольных проектов J2SE.
- Архив WAR - упакованная библиотека скомпилированных веб-классов только для веб-проектов.
- Библиотека - набор скомпилированных классов (в архиве JAR или WAR), исходного кода для отладки и документации Javadoc. Создать библиотеку можно выбрав Сервис > Менеджер библиотек в главном меню.
- Проект - результаты сборки (архив JAR/WAR), исходный код для отладки и документация Javadoc другого проекта NetBeans. Если вы добавите необходимый проект, то при сборке вашего главного проекта будут собраны все архивы JAR/WAR для обоих проектов. В примере проекта настольного приложения сборка проекта BlackJackUI также соберёт необходимый проект BlackJackLib.
Свободной формы
Ваш скрипт Ant должен самостоятельно обрабатывать путь к классам для компиляции и выполнения. Настройки проекта должны повторять связи содержимого и пути к классам, указанные в скрипте, для нормального функционирования дополнения, реорганизации кода и выделения ошибок. Можно настроить путь к классам для всего проекта или для каждой папки с исходными файлами. Для объявления пути к классам для существующего проекта свободной формы, щёлкните правой кнопкой мыши по узлу проекта и выберите Свойства. Затем в левой области выберите Путь к классам.
Установка контекста
Контекст предоставляет способ различия ресурсов одного веб-приложения от ресурсов другого, развёрнутых на одном и том же сервере.
Контекст приложения определяет адресное пространство содержимого веб-прилодения. Когда контекст установлен, доступ к веб-модулю осуществляется по адресу http://имяхоста:порт/контекст/сервлет_или_jsp. Например, если контекст установлен в /HelloWeb, то дочаться до веб-приложения можно введя адрес http://имяхоста:порт/HelloWeb/index.jsp.
