Импорт существующих веб-приложений среду NetBeans 4.0
Для создания проекта для существующего веб-приложения в NetBeans 4.0 существует два шаблона проекта:
- Веб-проект с существующими исходными файлами - Используйте данный шаблон для создания стандартного веб-проекта. Стандартный веб-проект использует средства интегрированной среды для компиляции, выполнения и отладки приложения.
- Веб-проект с существующим скриптом Ant - Выберите данный шаблон для создания веб-проекта свободной формы. Веб-проект свободной формы использует ваш существующий скрипт Ant для выполнения, компиляции и отладки.
Заставьте ваш код работать
Структура ваших исходных файлов может соответствовать нескольким проектам ИСР (интегрированной среды разработки). Поэтому вам, возможно, будет выгодней разбить ваши исходные файлы на несколько проектов с межпроектными зависимостями. Если, к примеру, частями ваших исходных файлов являются повторно используемые компоненты, апплеты или библиотеки тегов, то вам удобней будет создать несколько проектов-библиотек классов Java и создать зависимости между ними и вашими веб-проектами.
В данном документе мы сначала используем гипотетическое веб-приложение для того, чтобы показать как импортировать исходный код, неиспользующий скрипт сборки Ant. В этом случае NetBeans сама создаст для вас скрипт Ant. Затем мы импортируем пример приложения Tomcat "Hello World", которое поставляется вместе с установкой NetBeans. Данное приложение имеет собственный скрипт сборки, и вы узнаете как импортировать исходный код в том случае, когда вы хотите использовать уже существующий скрипт Ant для работы со своим веб-приложением.
Использование среды для сборки, выполнения и отладки
Создание проекта
- Выберите Файл > Создать проект (Ctrl-Shift-N).
- Выберите Веб > Веб-проект с существующими исходными файлами. Нажмите Далее.
- В поле Расположение нажмите Обзор для выбора корня веб-модуля вашего веб-приложения.
- Введите имя проекта в соответствующее поле. Данное имя будет также использовано для папки проекта и контекста. Примите во внимание, что контекст не может содержать пробелов. Если имя вашего проекта будет содержать пробелы, то в контексте они будут заменены на знаки подчёркивания. Например, проект "Servlet Examples" получит контекст "/servlet_examples".
- Создайте где-нибудь в вашей системе папку NetBeans_projects для размещения папок ваших проектов NetBeans. В поле Расположение проекта, нажмите Обзор для выбора папки NetBeans_projects.
- Нажмите Завершить. Проект откроется в интегрированной среде. Вы можете просмотреть его логическую организацию в окне Проекты и его файловую структуру в окне Файлы. Например, ваше приложение может выглядеть следующим образом:
Создание зависимостей между проектами
При создании отдельных проектов для каждого корня исходных файлов необходимо настроить зависимости между проектами. Обычно необходимо указать один главный проект и несколько необходимых проектов. Необходимый проект -- это проект, который добавлен в путь к классам другого проекта.
- Щёлкните правой клавишей мыши на проекте, к которому вы хотите добавить необходимый проект, и выберите Свойства. Окно Обычные диалога Свойства проекта показывает все необходимые проекты.
- Нажмите на Компиляция исходников в левой панели диалогового окна Свойства проекта.
- Нажмите Добавить проект.
- Выберите папку проекта, архивы JAR которого вы хотите добавить к пути к классам. Папки проектов интегрированной среды помечаются специальной иконкой-бэджиком. При выборе папки проекта отображаются его имя и архивы JAR.
- Нажмите Добавить архивы JAR проекта...
Выполнение приложения
- Выберите Выполнение > Выполнить главный проект для запуска вашего веб-приложения.
Использование собственного скрипта для сборки, выполнения и отладки
Создание проекта
- Выберите Файл > Создать проект (Ctrl-Shift-N).
- Выберите Веб > Веб-проект с существующим скриптом Ant. Нажмите Далее.
- В поле Расположение нажмите Обзор и выберите корень веб-модуля.
В данном примере корень веб-модуля находится в подпапке nb4.0\jakarta-tomcat-5.0.28\webapps\tomcat-docs\appdev\sample папки установки NetBeans. Выберите эту папку. Интегрированная среда заполнит остальные поля автоматически.
- Создайте где-нибудь в вашей системе папку NetBeans_projects для размещения папок ваших проектов NetBeans. В поле Расположение проекта, нажмите Обзор для выбора папки NetBeans_projects.
- Оставьте выбранным флажок Установить как главный проект. Нажмите Далее.
Связывание целей Ant с командами интегрированной среды
- Укажите, какие цели Ant интегрированная среда должна выполнять для команд проекта.
- Для сборки проекта выберите из списка compile.
- Для развёртывания проекта выберите install.
- Для повторного развёртывания выберите из списка reload.
Нажмите Далее.
Настройка папок с исходными файлами и папок пакетов
- Интегрированная среда автоматически заполнит поля Папка с веб-страницами и Папка с исходными файлами.
- В текстовое поле Контекст введите /MyProject. Примите во внимание, что контекст должен начинаться с косой черты и не должен содержать пробелов. Нажмите Далее.
- По желанию добавьте папки с исходными файлами. Для данного примера это не нужно.
- В поле Версия языка выберите версию JDK, с помощью которой ваш скрипт Ant выполняется и компилирует исходники. Для данного примера версия JDK -- 1.5. Нажмите Далее.
- По желанию добавьте архивы JAR к пути к классам проекта. Этот путь к классам не используется для компиляции или выполнения -- ваш скрипт Ant должен сам заботиться о пути к классам для данных задач. Эти же настройки сообщают NetBeans о том, какие классы включать в реорганизацию и дополнение кода.
- Нажмите Завершить. Проект откроется в интегрированной среде. Вы можете просмотреть его логическую организацию в окне Проекты и его файловую структуру в окне Файлы.
Настройка вашего скрипта Ant для использования с NetBeans
Раскройте узел MyProject в окне Проекты, откройте файл build.xml в редакторе исходных файлов и сделайте следующее:
- Измените свойство app.name в разделе File and Directory Names для настройки контекста:
<property name="app.name" value="MyProject"/>
Измените свойство projectname на значение контекста (без начальной косой черты /).
- Измените свойство catalina.home в разделе File and Directory Names для определения расположения сервера Tomcat. Например, если версия вашего сервера Tomcat -- 5.0.28 и NetBeans установлена в папку по умолчанию, используйте следующее определение свойства:
<property name="catalina.home"
value="C:\Program Files\netbeans-4.0\nb4.0\jakarta-tomcat-5.0.28"/>
- Если вы хотите изменить порт сервера Tomcat по умолчанию (8080), измените свойство manager.url в разделе File and Directory Names:
<property name="manager.url"
value="http://localhost:8084/manager"/>
- Измените раздел Custom Ant Task Definitions для установки переменной окружения CLASSPATH, используемого интегрированной средой, когда она выполняет скрипт сборки Ant. Например, ваши записи для задач "deploy","list", "reload" и "undeploy" могут выглядеть следующим образом:
<path id="catalina.ant.cp">
<pathelement path="${catalina.home}/server/lib/catalina-ant.jar"/>
</path>
<taskdef name="deploy" classname="org.apache.catalina.ant.DeployTask"
classpathref="catalina.ant.cp"/>
<taskdef name="list" classname="org.apache.catalina.ant.ListTask"
classpathref="catalina.ant.cp"/>
<taskdef name="reload" classname="org.apache.catalina.ant.ReloadTask"
classpathref="catalina.ant.cp"/>
<taskdef name="undeploy" classname="org.apache.catalina.ant.ReloadTask"
classpathref="catalina.ant.cp" />
- По желанию добавьте свои собственные цели к скрипту Ant и присвойте их командам проекта в интегрированной среде. Дополнительная информация находится на странице Расширенная настройка проекта свободного формата.
Выполнение приложения
- В окне Работа раскройте узел Реестр серверов и проверьте, выполняется ли ваш сервер Tomcat. Если нет, щёлкните правой кнопкой мыши по узлу вашего экземпляра сервер Tomcat и выберите Запустить или остановить сервер в контекстном меню.
- Щёлкните правой кнопкой мыши по проекту в окне Проекты и выберите Выполнение проекта из контекстного меню. Во время подготовки программы к развёртыванию появится окно монитора выполнения.
- Во время первого выполнения приложения за сеанс, сервер Tomcat спросит у вас имя пользователя и пароль. Единственные допустимы -- имя и пароль пользователя с ролью "manager", которые определены в файле tomcat-users.xml в базовой папке Tomcat. Для определения расположения данной папки, щёлкните правой кнопкой мыши по узлу вашего экземпляра сервера Tomcat в окне Работа и выберите Свойства. В открывшемся диалоговом окне посмотрите значение свойства Базовая папка.
- Откройте любой браузер и в строку адреса введите http://localhost:8084/MyProject. Ваш браузер откроет пример приложения Tomcat "Hello World".
Отладка приложения
- В окне Проекты, перейдите к файлу build.xml вашего проекта.
- Дважды щёлкните по файлу build.xml. Он откроется в редакторе исходных файлов, в котором вы сможете изменить или добавить цель для отладки в NetBeans. Дополнительная информация находится на странице Написание цели для отладки вашего веб-приложения.
