Импорт существующего исходного кода 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:

Папка проекта также содержит папку результатов сборки для скомпилированных классов, архивов JAR (для настольных приложений под J2SE) или архивов WAR (для веб-проектов) и документации Javadoc.

Свободной формы

При указании расположения проекта свободной формы, это расположение не обязательно указывает папку со скриптом Ant. Например, если все ваши пакеты с исходными файлами организованы в одну папку, вы можете установить эту папку для размещения проекта, даже если она не содержит скрипта сборки. Расположения папок с результатами сборки зависит от настроек в вашем скрипте Ant.


Корень веб-модуля

Корень веб-модля - это папка верхнего уровня веб-приложения. В ней находятся страницы JSP, классы и архивы для клиента и такие статические веб-ресурсы как картинки. Нижеприведённый рисунок показывает структуру исходных файлов типичного веб-приложения.


Главный проект

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

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


Связывание команд с целями Ant

Проекты свободной формы опираются на скрипт Ant в плане предоставления целей для всех действий интегрированной среды, включая такие действия:

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

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


Окна Проекты и Файлы

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

Окно Файлы показывает физическое размещение файлов проекта на диске. Показываются папка проекта и каждая из папок с исходными файлами для каждого проекта. Папка nbproject содержит метаданные о проекте.


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


Стандартный

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

Свободной формы

Ваш скрипт Ant должен самостоятельно обрабатывать путь к классам для компиляции и выполнения. Настройки проекта должны повторять связи содержимого и пути к классам, указанные в скрипте, для нормального функционирования дополнения, реорганизации кода и выделения ошибок. Можно настроить путь к классам для всего проекта или для каждой папки с исходными файлами. Для объявления пути к классам для существующего проекта свободной формы, щёлкните правой кнопкой мыши по узлу проекта и выберите Свойства. Затем в левой области выберите Путь к классам.


Установка контекста

Контекст предоставляет способ различия ресурсов одного веб-приложения от ресурсов другого, развёрнутых на одном и том же сервере.

Контекст приложения определяет адресное пространство содержимого веб-прилодения. Когда контекст установлен, доступ к веб-модулю осуществляется по адресу http://имяхоста:порт/контекст/сервлет_или_jsp. Например, если контекст установлен в /HelloWeb, то дочаться до веб-приложения можно введя адрес http://имяхоста:порт/HelloWeb/index.jsp.