В этом документе рассматривается процесс переноса приложений NetBeans Visual Web Pack в среду IDE NetBeans с поддержкой веб-технологий.
Для работы с данным руководством необходимо установить среду NetBeans 6.0 или 6.1 и выбрать вариант установки "Web & Java EE" или "Full". Для получения дополнительных сведений о работе со средой IDE NetBeans см. страницу Поддержка и документы на веб-сайте NetBeans.
Visual Web JSF Backwards Compatibility Kit предоставляет дополнительные библиотеки, которые требуются разработчику визуальных веб-приложений для поддержки проектов на основе J2SE 1.4 или J2EE 1.4. Сюда входят следующие библиотеки:
Перед запуском среды IDE NetBeans проверьте, что закрыты все экземпляры среды IDE NetBeans 6.0 или 6.1 и Java Studio Creator. При установке среды IDE NetBeans 6.0 или 6.1 с поддержкой веб-технологий после первого запуска среды IDE появляется запрос на перенос параметров настройки, показанный на следующем рисунке. Для переноса параметров настройки нажмите кнопку "Yes" в диалоговом окне "Confirm Import Settings".
Если требуется открыть проект, который был разработан в другой версии среды IDE, а пользовательские параметры настройки для соответствующей версии не были перенесены, можно воспользоваться следующим обходным способом:
- Закройте среду IDE NetBeans.
- Измените имя каталога пользователя версии IDE, который не требуется переносить.
- Удалите каталог пользователя IDE NetBeans 6.0 или 6.1. Для получения данных о местоположении каталога пользователя выберите "Help > About", как показано на Рис. 2 ниже.
- Перезапустите среду IDE NetBeans.
- В диалоговом окне "Confirm Import Settings" нажмите кнопку "Yes" для переноса параметров настройки для версии, использованной при создании проекта.
Каталог пользователя создается при каждом запуске среды IDE. Файл, удаленный в действии 3, создается повторно.
Для появления запроса при следующем запуске среды IDE NetBeans переименуйте каталог пользователя. Для получения данных о местоположении каталога пользователя выберите "Help > About", как показано на рисунке ниже.
Перенос исходных файлов при открытии проекта
Всегда создавайте копии папок проекта перед открытием проектов в среде IDE NetBeans 6.0 или 6.1.После открытия проекта, созданного в NetBeans Visual Web Pack, открыть этот проект в более ранней версии среды IDE будет невозможно. Совместное использование проектов между NetBeans Visual Web Pack и IDE NetBeans 6.0 или 6.1 не поддерживается. Примечание: Поддержка EJB и веб-служб ограничена.
При первом открытии приложения Visual Web Pack в среде IDE NetBeans 6.0 или 6.1 путем выбора "File > Open Project" выполняется перенос следующих исходных файлов:
- Библиотеки элементов, добавленные в IDE. При открытии проекта в среде IDE NetBeans появляется диалоговое окно с сообщением о том, что используемые в проекте библиотеки элементов добавляются к "Palette/Tools > Component Library Manager". Может потребоваться вручную разрешить некоторые ссылки на библиотеки. Для получения дополнительных сведений см. Разрешение ссылок на библиотеки.
- Драйверы и подключения JDBC при открытии проекта не импортируются. Фактически это выполняется при разворачивании узла "Project" на вкладке "Project". При этом появляется индикатор хода выполнения "Updating Legacy Project". Простое открытие проекта не инициирует импорт параметров настройки БД.
Примечание: Рекомендуется удалить папку "private" из копии проекта, который требуется перенести. Эта папка расположена по пути myProject/nbproject/private.
Переходы по страницам
Редактор переходов на странице, используемый в Visual Web Pack, заменен редактором потока операций на странице в среде IDE NetBeans 6.0 и 6.1.
В VWP 5.5, 5.1, а также в Java Studio Creator проекты имели три файла настройки Faces для разных целей:
- managed-beans.xml.Этот файл предназначался для всех записей управляемых компонентов (включая сеансный компонент, компонент запроса и компонент приложения).
- navigation.xml.Этот файл содержал все правила перехода.
- faces-config.xml.Этот файл, как правило, был пустым, если какие-либо значения не были введены вручную.
Напротив, для новых проектов в NetBeans 6.0 или 6.1 все данные хранятся в одном файле "faces-config.xml" по умолчанию. Однако при этом можно добавить новые файлы настройки Faces, а также собственные правила или значения в них.
Новый редактор потока операций на странице может использоваться с любым файлом настройки Faces.
Новый редактор потока операций на странице обеспечивает 3 различных представления для просмотра правил перехода (для перехода между представлениями используется раскрывающийся список рядом с кнопкой "XML"):
- Project.Это представление по умолчанию, в котором отображаются все страницы в проекте (включая страницы JSF, html и т.д.) вместе со всеми правилами перехода из конкретного файла настройки Faces.
- Faces Configuration Only.Аналогично, в этом представления показаны все правила в текущих файлах настройки Faces, но отображаются только релевантные страницы.
- All Faces Configuration.В этом представлении правила перехода и случаи из всех файлов настройки Faces объединены вместе и отображаются вместе со всеми релевантными страницами.
Для получения дополнительных сведений о переходах по страницам см. руководство по Visual Web Pack Переходы по страницам в веб-приложении. В данном руководстве описаны все возможности переходов по страницам в интегрированной среде разработки NetBeans 6.0 и 6.1.
Файлы настройки
При импорте проекта для пользователей отображаются три файла настройки:
- faces-config.xml
- navigation.xml
- managed-beans.xml
Важно учесть, что все правила в этих файлах настройки объединяются при запуске проекта. Можно вызвать редактор потока операций на странице для всех трех файлов и добавить правила перехода к ним, но это может привести к конфликтам правил в разных файлах. Конфликтующее правило перехода может появиться при наличии идентичных элементов "from-view-id" и "from-outcome", но различных элементов "to-view-id" в разных файлах. Ниже приводятся два блока кода, иллюстрирующие пример этого случая:
<navigation-rule>
<from-view-id>*/Page1.jsp*</from-view-id>
<navigation-case>
<from-outcome>*case1*</from-outcome>
<to-view-id>*/Page2.jsp*</to-view-id>
</navigation-case>
</navigation-rule>
<navigation-rule>
<from-view-id>*/Page1.jsp*</from-view-id>
<navigation-case>
<from-outcome>*case1*</from-outcome>
<to-view-id>*/Page3.jsp*</to-view-id>
<redirect/>
</navigation-case>
</navigation-rule>
Если для правил перехода в импортируемых проектах используется только "navigation.xml", проблем возникнуть не должно. Для разрешения таких конфликтов используются следующие правила:
- Если возникает конфликт между faces-config.xml и другим файлом, faces-config.xml всегда имеет приоритет.
- Если возникает конфликт между двумя другими файлами настройки, например navigation.xml и managed-beans.xml, то приоритет имеет последний файл в параметре контекста web.xml (javax.faces.CONFIG_FILES).
Для просмотра правил из всех файлов настройки в одном представлении с возможностью удаления любой избыточности:
- Щелкните правой кнопкой мыши в Visual Designer и выберите в контекстном меню "Page Navigation".
Выберите "Project" в раскрывающемся списке "Configuration Scope" в редакторе потока операций на странице, как показано на рисунке ниже.
Следует отметить, что после переноса проекта среда IDE регистрирует значение управляемого компонента новых страниц в faces-config.xml, а не в managed-beans.xml, как выполнялось в Sun Java Studio Creator и в NetBeans 5.5.
Разрешение ссылок на библиотеки
При появлении сообщения об ошибке, указывающего на неразрешенные ссылки на библиотеки, необходимо удалить эти ссылки. При удалении ссылок на библиотеки риск для проекта отсутствует.
- Щелкните правой кнопкой мыши узел проекта и выберите "Properties".
- Щелкните узел "Libraries" и удалите значения в окне "Compile", значок которых имеет желтый символ рядом с недопустимой ссылкой на библиотеку.
- Разверните узел "Build > Packaging" и удалите все недопустимые ссылки на библиотеки.
Работа с базами данных
Описанная ниже процедура используется для переноса проекта, созданного на том же компьютере и тем же пользователем в более ранней версии NetBeans или Sun Java Studio Creator.
Если проект был создан на другом компьютере или другим пользователем с помощью более ранней версии NetBeans или Sun Java Studio Creator, потребуется выполнить дополнительные действия.
- Откройте проект, созданный в среде IDE NetBeans Visual Web.
- Щелкните правой кнопкой мыши узел "Project > Data Source References" и выберите "Resolve Data Sources".
Примечание: Для проектов, созданных в Java Studio Creator, следует закрыть, а затем снова открыть проект.
- В диалоговом окне "Add Database Connection" добавьте драйвер JDBC, если он еще не зарегистрирован, либо установите драйвер с помощью раскрывающегося списка, а затем нажмите кнопку "OK".
- Повторите действие 3, если в проекте используются подключения к нескольким базам данных.
Кроме того, проверьте, что целевой сервер приложений зарегистрирован на вкладке "Services". По умолчанию зарегистрирован сервер приложений GlassFish V2.
Развертывание перенесенных приложений
Программы установки для стандартной и полной версий среды IDE NetBeans 6.0 или 6.1 предусматривают установку сервера приложений Sun Java System Application Server, который является версией сервера приложений GlassFish. Если перенесенный проект первоначально был развернут на сервере Sun Java System Application Server, можно выполнить развертывание этого проекта в среде IDE NetBeans 6.0 или 6.1.
Если перенесенное приложение было первоначально развернуто на сервере, отличном Sun Java System Application Server, то для развертывания такого приложения требуется внести изменения.
Для развертывания проекта на сервере Tomcat необходимо установить Tomcat, который можно загрузить по адресу tomcat.apache.org. Версии Tomcat 5 и 6 протестированы для использования со средой IDE NetBeans 6.0 и 6.1. Для получения дополнительных сведений о развертывании на сервере Tomcat см. часто задаваемые вопросы по теме Добавление внешнего сервера Tomcat и Развертывание внешнего сервера Tomcat в среде NB6.
Помощь при переносе проекта
В случае появления дополнительных вопросов о переносе проектов из NetBeans Visual Web Pack в среду IDE NetBeans 6.0 или 6.1 воспользуйтесь ссылкой для отзывов в конце этой статьи.
Дополнительная информация
Дата последнего изменения страницы: 15 апреля 2008 г.
