// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Добавление поддержки веб-платформы
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Добавление поддержки веб-платформы - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Добавление поддержки веб-платформы

В этом документе приведено общее описание способа добавления поддержки к веб-платформе в IDE NetBeans. В приведенных действиях показано, как можно добавить эту поддержку, установив подключаемый модуль веб-платформы в среду IDE, с помощью диспетчера подключаемых модулей. После установки подключаемого модуля платформу можно будет выбирать при создании веб-проектов в мастере создания проектов. Новый веб-проект будет сразу включать всю необходимую инфраструктуру для выбранной платформы.

Простейшим способом добавления поддержки для определенной веб-платформы является установка подключаемого модуля NetBeans, если таковой доступен, при помощи диспетчера подключаемых модулей среды IDE. Это удобно, если при работе в среде IDE имеется доступ к Интернету. Подключаемые модуля для многих веб-платформ также доступны через link:http://plugins.netbeans.org/PluginPortal/[+Портал подключаемых модулей NetBeans+]. При отсутствии постоянного доступа к Интернету подключаемые модули (например, с вышеупомянутого портала) можно загружать по мере возможности и устанавливать их в среду IDE позже.

В этом руководстве мы добавим поддержку для платформы Apache Struts 2, загрузив подключаемый модуль с портала подключаемых модулей NetBeans и установив его с помощью диспетчера подключаемых модулей.

*Примечание. * В комплект IDE реализована поддержка платформ link:../../docs/web/jsf20-support.html[+JavaServer Faces 2.x+], link:../../docs/web/quickstart-webapps-struts.html[+Struts 1.3.10+], а также link:../../docs/web/quickstart-webapps-spring.html[+Spring 3.x и 4.x+]. Версия включенной в комплект платформы зависит от версии IDE.


image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]


*Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.*

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans, Java EE bundle+] |7.2, 7.3, 7.4, 8.0 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+] |версия 7 или 8 
|===

*Примечания:*

* Вариант установки "Web и Java EE" позволяет дополнительно установить сервер GlassFish 3.1 и контейнер сервлетов Apache Tomcat 6.0.x. В зависимости от используемой платформы необходимо один из этих элементов для работы с этим учебным курсом.
* Также необходимо подключение к Интернету для загрузки необходимых подключаемых модулей и/или доступа к ним через диспетчер подключаемых модулей среды IDE.


== Установка подключаемых модулей поддержки платформы

Поддержку определенной платформы можно добавить, установив подключаемые модуля поддержки этой платформы в среду IDE. Чтобы выполнить это, можно загрузить подключаемые модуля с внешнего веб-сайта, такого как link:http://plugins.netbeans.org/PluginPortal/[+Портал подключаемых модулей NetBeans+], с последующей их установкой при помощи диспетчера подключаемых модулей, либо, если подключаемый модуль находится в центре обновлений, этот центр обновлений можно зарегистрировать в диспетчере подключаемых модулей среды IDE и затем установить подключаемый модуль напрямую через диспетчер подключаемых модулей.

* <<manually,Загрузка вручную>>
* <<updateCenter,Установка из центра обновлений>>

Некоторые подключаемые модуля доступны для загрузки с сайтов, таких как link:http://plugins.netbeans.org/PluginPortal/[+Портал подключаемых модулей NetBeans+] или сайты их разработчиков. В таблице ниже приведены ссылки, по которым можно загрузить некоторые подключаемые модуля для платформ.

|===
|Платформа |Местоположение подключаемого модуля |Местоположение загрузки 

|link:http://struts.apache.org/[+Apache Struts 2+] |link:http://java.net/projects/nbstruts2support/[+http://java.net/projects/nbstruts2support/+] |link:http://plugins.netbeans.org/plugin/39218/struts2-support-repack-for-nb-7-0[+ http://plugins.netbeans.org/plugin/39218/struts2-support-repack-for-nb-7-0+] 

|link:http://wicket.apache.org/[+Wicket+] |link:http://nbwicketsupport.dev.java.net/[+https://nbwicketsupport.dev.java.net+] |link:http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=3586[+ http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=3586+] 

|link:http://www.icefaces.org/main/home/[+ICEfaces 2.0+] |link:http://www.icefaces.org/main/home/[+http://www.icefaces.org/main/home/+] |link:http://www.icefaces.org/main/downloads/[+ http://www.icefaces.org/main/downloads/+] 
|===


=== Загрузка и установка подключаемого модуля поддержки Apache Struts 2

В данном разделе в качестве примера описано, как загрузить и установить подключаемый модуль link:http://plugins.netbeans.org/plugin/39218/struts2-support-repack-for-nb-7-0[+Apache Struts 2 Support Repack for NB 7.0+] с портала подключаемых модулей NetBeans. Этот подключаемый модуль устанавливает библиотеки и элементы интерфейса пользователя, необходимые для поддержки Apache Struts 2.

*Примечание.* Подключаемый модуль повторно включает в упаковку link:http://java.net/projects/nbstruts2support/[+Подключаемый модуль поддержки Struts2 NetBeans+], поскольку подключаемый модуль поддержки Struts2 NetBeans не обновлялся для IDE NetBeans 7.0. Для получения дополнительных сведений обо всех подключаемых модулях см. соответствующие страницы сведений о подключаемых модулях.

1. Загрузите архив zip, содержащий подключаемые модули Apache Struts 2, со link:http://plugins.netbeans.org/plugin/39218/struts2-support-repack-for-nb-7-0[+ страницы Struts2 Support Repack for NB 7.0+] link:http://plugins.netbeans.org/PluginPortal/[+Портала подключаемых модулей NetBeans+] и извлеките содержимое на свой компьютер.

После извлечения содержимого можно будет увидеть, что в архиве содержатся три файла.

*  ``org-netbeans-modules-web-frameworks-struts2.nbm`` 
*  ``org-netbeans-modules-web-frameworks-struts2lib218.nbm`` 
*  ``org-netbeans-modules-web-frameworks-struts2lib20011.nbm`` 

Подключаемые модули NetBeans можно опознать по их расширению  ``.nbm`` .

2. Из основного меню среды IDE выберите Tools ("Сервис") > Plugins ("Подключаемые модули") для открытия диспетчера подключаемых модулей.
3. Выберите вкладку Downloaded ("Загруженные") и нажмите кнопку Add Plugins ("Добавление подключаемых модулей").
4. В диалоговом окне добавления подключаемых модулей перейдите к содержащему их каталогу и выберите модуль NetBeans. Нажмите кнопку Open ("Открыть").
image::images/plugin-archive-contents.png[title="Архив zip содержит подключаемые модули NetBeans"]

Нажмите и удерживайте клавишу Ctrl для выбора нескольких элементов.

5. В диспетчере подключаемых модулей выберите каждый из модулей Struts2.

Описание выбранного подключаемого модуля отображается на правой панели диспетчера подключаемых модулей.

[.feature]
--
image::images/add-plugins-sm.png[role="left", link="images/add-plugins.png"]
--
6. Щелкните 'Установить', чтобы открыть установщик IDE NetBeans, а затем щелкните 'Далее' и примите условия лицензионного соглашения.

*Примечание.* При получении предупреждения проверки для установки подключаемого модуля щелкните 'Продолжить'. Предупреждение проверки выдается при попытке установить неподписанный подключаемый модуль. Хотя обычно всем подключаемым модулям можно доверять, установка неподписанного модуля осуществляется на ваш страх и риск.

7. Перезапустите среду IDE, чтобы дать изменениям возможность вступить в силу.

После установки подключаемого модуля и перезапуска среды IDE можно убедиться в том, что он установлен, открыв диспетчер подключаемых модулей, щелкнув вкладку Installed ("Установленные") и найдя его в списке установленных подключаемых модулей.


=== Установка из центра обновлений

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

Ряд центров обновлений зарегистрирован в среде IDE по умолчанию. Чтобы увидеть список центров обновлений, зарегистрированных в настоящий момент, откройте диспетчер подключаемых модулей (Tools ("Средства") > Plugins ("Подключаемые модули")) и выберите вкладку Settings ("Параметры").

[.feature]
--
image::images/pluginsmanager-settings-sm.png[role="left", link="images/pluginsmanager-settings.png"]
--

Если необходимо зарегистрировать новый центр обновлений, нажмите кнопку Add ("Добавить") на вкладке Settings ("Параметры") и введите сведения в настройщик центра обновлений.

image::images/uc-customizer.png[title="Диалоговое окно 'Средство настройки центра обновлений'"] 


=== Регистрация центра обновлений портала подключаемых модулей NetBeans

Центр обновлений портала подключаемых модулей, зарегистрированный в среде IDE по умолчанию, содержит подмножество подключаемых модулей, предоставленных сообществом и проверенных на совместимость с установленной версией среды IDE. Если необходимо использовать диспетчер подключаемых модулей для просмотра всех модулей, доступных на link:http://plugins.netbeans.org/[+портале подключаемых модулей NetBeans+], то для установки подключаемого модуля и добавления центра обновлений портала подключаемых модулей NetBeans к списку зарегистрированных центров обновлений можно выполнить следующие действия.

1. Загрузите link:http://plugins.netbeans.org/plugin/1616/plugin-portal-update-center[+подключаемый модуль центра обновлений портала подключаемых модулей NetBeans+].
2. Откройте вкладку Downloaded ("Загруженные") в диспетчере подключаемых модулей.
3. Щелкните Add Plugins ("Добавление подключаемых модулей") и найдите загруженный файл  ``1252666924798_org-netbeans-pluginportaluc.nbm`` . Нажмите кнопку "Установить".

После установки подключаемого модуля центр обновлений портала подключаемых модулей NetBeans добавляется к списку зарегистрированных центров обновлений на вкладке Settings ("Параметры") диспетчера подключаемых модулей.

*Примечание.* Вы можете отключить центр обновления, сняв флажок для центра обновлений в столбце 'Активный' на вкладке 'Настройки'.

[.feature]
--
image::images/portal-uc-plugin-sm.png[role="left", link="images/portal-uc-plugin.png"]
--

Если щелкнуть вкладку Available Plugins ("Доступные подключаемые модули"), то можно будет увидеть, что все подключаемые модули, загруженные сообществом на портал подключаемых модулей NetBeans, были внесены в список доступных подключаемых модулей.

Щелкните Reload Catalog ("Перезагрузить каталог"), чтобы обновить список подключаемых модулей.

[.feature]
--
image::images/portal-uc-list-sm.png[role="left", link="images/portal-uc-list.png"]
--

Этот список можно упорядочить, щелкнув заголовок столбца, либо отфильтровать, введя условия в поле поиска.

* В центре обновлений портала подключаемых модулей перечислены все подключаемые модули, доступные через link:http://plugins.netbeans.org/[+портал подключаемых модулей NetBeans+]. Многие из подключаемых модулей будут предназначены для устаревших версий среды IDE и будут несовместимы с используемой версией среды IDE. Установка подключаемых модулей для других версий IDE может привести к нестабильной работе имеющейся установки среды IDE.* Во многих случаях, но не во всех, будет отображено сообщение с уведомлением о том, подключаемый модуль не может быть установлен. Как и при установке любого программного обеспечения, следует соблюдать осторожность и тщательно прочесть документацию перед попыткой установки подключаемого модуля.


== Работа с поддержкой платформы в среде IDE

Поддержка платформа в среде IDE обычно относится к конкретной используемой платформе. Например, поддержка Struts2 предоставляет мастера, позволяющие легко создавать часто используемые классы Struts, а также автозавершение кода в файлах настройки Struts.

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

* <<newProject,Создание нового проекта с поддержкой платформы>>
* <<existingProject,Добавление поддержки платформы к существующему проекту>>


=== Создание нового проекта с поддержкой платформы

1. Выберите "Файл > Новый проект" (CTRL+SHIFT+N; &amp;#8984+SHIFT+N в Mac ОС) в главном меню. Откроется мастер создания проекта. Выберите Web ("Сеть") в Categories ("Категории"), затем в Projects ("Проекты") выберите Web Application ("Веб-приложение"). Нажмите кнопку "Далее".
2. Введите имя в поле Project Name ("Имя проекта") и укажите местоположение для проекта на используемом компьютере.
3. Пройдите через этапы работы мастера, принимая все параметры по умолчанию. Укажите серверу развернуть приложение, выбрав один из серверов приложений, уже зарегистрированных в IDE (т. е. сервер GlassFish или Tomcat).
4. На панели Frameworks ("Платформы") мастера создания проектов выберите платформу, которую нужно добавить. Нажмите кнопку "Готово". 
image::images/newproject-wizard-frameworks-sm.png[title="Поддержка Struts 2 указана на панели 'Платформы' мастера создания проектов"]

В данном примере поддержка платформы Struts 2 указана на панели Frameworks ("Платформы"). Можно увидеть, что панель Frameworks ("Платформы") теперь предлагает выбор между Struts 1.3.8 (входящей в среду IDE) или Struts2 (добавленной посредством подключаемого модуля). При установке подключаемого модуля поддержки Struts2 в мастер создания проектов добавляется пункт Struts2, а также вкладки с параметрами для настройки и библиотек. Вкладка Configuration ("Настройка") предоставляет возможность создать образец страницы в проекте. Вкладка Libraries ("Библиотеки") позволяет выбрать версию библиотек Struts2, которую следует добавить к пути к классам.

При нажатии кнопки Finish ("Готово") среда IDE создаст веб-приложение. Дополнительные файлы, создаваемые мастером, будут различными в зависимости от платформы. В этом примере мастер создал  ``struts.xml`` , файл настройки XML, в папке Source Packages ("Пакеты исходного кода") и добавил библиотеки Struts2 к пути к классам. Мастер автоматически добавил класс фильтра Servlet и привязку фильтра к  ``web.xml`` .

image::images/project-structure-frameworks.png[title="Логическая структура веб-приложения Struts отображается в окне 'Проекты'"]  


=== Добавление поддержки платформы к существующему проекту

При наличии существующего веб-проекта и необходимости добавить к нему поддержку платформы можно использовать диалоговое окно Project Properties ("Свойства проекта") для добавления платформ, доступных в среде IDE.

1. В окне 'Проекты' щелкните правой кнопкой мыши узел веб-приложения и выберите 'Свойства'. В результате откроется окно 'Свойства проекта'.
2. В списке 'Категории' выберите 'Платформы'.

После выбора значения 'Платформы' на правой панели отображается текстовая область 'Используемые платформы'. Если приложение не использует никакие платформы, эта область будет пуста.

3. Нажмите кнопку 'Добавить', выберите нужную платформу и нажмите OK. 
image::images/properties-add-framework.png[title="Платформа JavaServer Faces выбрана в диалоговом окне 'Добавление платформы', открытом в окне 'Свойства проекта'"]
4. В зависимости от выбранной платформы укажите относящиеся к этой платформе параметры конфигурации или компоненты, представленные в окне 'Свойства проекта'.
image::images/add-icefaces.png[title="Добавление библиотеки для набора компонентов ICEfaces в проект"]

Например, если вы хотите указать набор компонентов ICEfaces, можно выбрать ICEfaces на вкладке 'Компоненты' в окне 'Свойства проекта' и указать библиотеку ICEfaces.

*Примечания.* Библиотеки для компонентов JSF не входят в комплект IDE. Чтобы использовать наборы компонентов, необходимо загрузить требуемые библиотеки и создать библиотеку NetBeans, которую затем можно добавить в путь классов проекта в окне 'Свойства проекта'.

5. Нажмите кнопку "OК", чтобы подтвердить свой выбор, и закройте окно Project Properties ("Свойства проекта"). К проекту будут добавлены относящиеся к этой платформе артефакты и библиотеки, которые можно изучить в окне проектов.
link:/about/contact_form.html?to=3&subject=Feedback:%20Adding%20Web%20Framework%20Support[+ Отправить отзыв по этому учебному курсу+]


== Дополнительные сведения

В этом документе приведено описание способа добавления поддержки к веб-платформе в IDE NetBeans. Показано, как установить подключаемые модули поддержки платформ путем загрузки их вручную или использования диспетчера подключаемых модулей среды IDE. Кроме того, показано, как добавить поддерживаемую средой IDE платформу к новому веб-приложению или существующему проекту.

В данном руководстве в качестве примера используется платформа Struts2. Тем, кто хочет изучить другие функции, предлагаемые этой платформой, стоит заглянуть во link:../../docs/web/quickstart-webapps-struts.html[+Введение в веб-платформу Struts+].

Дополнительные сведения об использовании других веб-платформ в IDE NetBeans см. следующие ресурсы:

* link:../../docs/web/quickstart-webapps-spring.html[+Введение в веб-платформу Spring+].
* link:../../docs/web/quickstart-webapps-struts.html[+Введение в веб-платформу Grails+]
* link:../../docs/web/quickstart-webapps-wicket.html[+Введение в веб-платформу Wicket+].