blob: 46314391fe83aa9c66d3eaefae5a766e428a9b87 [file] [log] [blame]
//
// 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, Интеграция апплета в веб-приложение
Апплет это программа, написанная на языке программирования Java и встраиваемая в страницу HTML способом, в многом похожим на вставку изображения на страницу. Приложение, которое будет создано в этом учебном курсе, показывает, как выполнять сборку и развертывание апплетов в среде IDE.
*Примечание. *Хотя нет шаблонов проектов, которые специально разработаны для создания апплетов в IDE, их можно легко разработать в проекте Java и упаковать их в веб-проект, как показано в этом учебном курсе.
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+] |7.2, 7.3, 7.4, 8.0, версия Java
|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+] |версия 7 или 8
|GlassFish Server Open Source Edition
_или_
Контейнер сервлетов Tomcat |3.x или 4.x
_ _
версия 7.x или 8.x
|===
== Создание или импорт файла исходного кода апплета
В этом разделе вы создадите свой первый апплет. Если у вас уже есть апплет, то указания, приведенные ниже, помогут импортировать его в среду IDE.
=== Создание проекта Java с нуля или с использованием имеющихся исходных кодов
1. Выберите команду "Файл" > "Создать проект" (CTRL+SHIFT+N). В области "Категории" выберите "Java".
2. Выполните одно из следующих действий.
* Для создания нового исходного файла в области "Проекты" выберите пункт "Библиотека классов Java". Нажмите кнопку "Далее".
* Для импорта исходного файла апплета выберите пункт "Проект Java с существующим исходным кодом". Нажмите кнопку "Далее". Укажите местоположение файла в текстовом поле "Папка с исходными файлами".
. В поле "Имя проекта" введите ``HelloApplet`` . В области "Расположение проекта" укажите любую папку на своем компьютере.
. Нажмите кнопку "Завершить". Если файл исходного кода апплета был импортирован, <<runanddebug,запустите его>>.
=== Создание файла исходного кода апплета
1. Нажмите название проекта HelloApplet правой кнопкой мыши и выберите пункт "Свойства", при этом откроется окно "Свойства".
2. Выберите нужный формат исходных/двоичных файлов для проекта и нажмите ОК.
*Примечание.* Если выбрана версия JDK 1.6, апплет может не запускаться на компьютерах, на которых установлена предыдущая версия JRE или подключаемого модуля Java для браузера.
. Нажмите узел HelloApplet в окне "Проекты" и выберите "Новый" > "Другое" (Ctrl-N).
. В области "Категории" выберите "Java". В области "Типы файлов" выберите "Апплет".
Если же нужно использовать визуальные средства для разработки апплета, выберите "Формы Swing GUI" > "Форма JApplet".
Нажмите кнопку "Далее".
. В области "Имя класса" введите ``MyApplet`` . В поле "Пакет" введите ``org.me.hello`` .
. Нажмите кнопку "Завершить".
Среда IDE создает исходный файл апплет в указанном пакете. Исходный файл апплета открывается в редакторе исходного кода.
. Определите класс своего апплета, заменив существующий стандартный код следующим кодом:
[source,java]
----
package org.me.hello;
import java.applet.Applet;
import java.awt.Graphics;
public class MyApplet extends Applet {
@Override
public void paint(Graphics g) {
g.drawString("Hello applet!", 50, 25);
}
}
----
В качестве альтернативы, если вместо этого выполняется разработка форма апплета используйте документ link:../java/quickstart-gui.html[+Разработка графического интерфейса пользователя Swing в IDE NetBeans+] для создания аналога следующему:
image::images/movie-magic-quiz-design.png[]
Подробную информацию о написании апплетов см. в разделеlink:http://download.oracle.com/javase/tutorial/deployment/applet/index.html[+Апплеты+] Руководства Java^TM^.
== Запуск файла исходного кода апплета
Созданный апплет можно запустить из среды IDE. В этом разделе вы узнаете, как это сделать.
=== Сборка и выполнение исходного файла апплета
Щелкните правой кнопкой мыши узел файла MyApplet.java в окне 'Проекты' и выберите в контекстном меню команду 'Запустить файл'. В папке ``сборки`` создается файл запуска ``MyApplet.html`` со встроенным апплетом. Его можно увидеть, перейдя в окно "Файлы" (CTRL+2):
image::images/built-project-files.png[]
Апплет запускается в программе просмотра апплета.
image::images/appletviewer.png[]
Формы апплета также отображаются в программе просмотра апплета.
image::images/movie-magic-quiz.png[]
== Внедрение апплета в веб-приложение
Итак, создание апплета завершено. Теперь необходимо предоставить к нему доступ пользователю. Для этого необходимо создать веб-приложение, добавить апплет JAR в путь к его классам, а затем добавить тег апплета в файл HTML веб-приложения.
=== Создание веб-проекта
1. Выберите команду "Файл" > "Новый проект".
2. В категории Java Web выберите 'Веб-приложение'. Нажмите кнопку "Далее".
3. В области "Имя проекта" введите ``HelloWebApplet`` .
4. В области "Расположение проекта" укажите любую папку на своем компьютере. Нажмите кнопку "Далее".
5. Выберите целевой сервер. Нажмите кнопку "Завершить".
=== Добавление файла JAR апплета в веб-проект
Когда нужно включить файл апплета в формате JAR в веб-проект, можно добавить либо проект Java, содержащий файл JAR file, либо добавить сам файл JAR. Можно выбрать любой из вариантов, однако следует учесть, что при добавлении проекта Java в веб-проект среда IDE запускает сборку апплета при каждой сборке веб-приложения. Таким образом, если вы изменяете апплет в проекте Java, среда IDE собирает новую версию апплета каждый раз при сборке веб-проекта. С другой стороны, если файл JAR апплета не находится в проекте IDE NetBeans, исходный файл апплета не перестраивается при построении веб-проекта.
*Примечание.* Если на этом этапе используется проект ``HelloApplet`` в IDE файл ``HelloApplet.jar`` отсутствует. Это нормально. Файл ``HelloApplet.jar`` будет собран при сборке проекта ``HelloWebApplet`` .
1. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта HelloWebApplet и выберите 'Свойства' в контекстном меню.
2. Выберите категорию 'Упаковка'.
3. Выполните одно из следующих действий.
* Если апплет находится в проекте Java, нажмите 'Добавить проект' и найдите каталог этого проекта Java. Щелкните Add JAR/Folder ("Добавить JAR/Папку").
*Примечание.* Проекты IDE помечены специальным значком 'Проект NetBeans IDE'.
* Если используемый файл апплета JAR не входит в проект IDE, нажмите 'Добавить файл/папку' и найдите папку с файлом JAR. Нажмите 'Выбрать'.
. Убедитесь, что JAR с исходным файлом апплета отображается в таблице в окне 'Свойства проекта'. Нажмите кнопку "ОК".
По умолчанию файл JAR апплета будет скопирован в библиотеку страницы веб-приложения (папку ``build/web `` ). Папка ``build/web `` является корневым каталогом приложения и отображается в таблице как " ``/`` " в переменной Path в столбце WAR. Вы можете изменить расположение апплета в WAR. Для этого введите новое расположение апплета в переменной Path в столбце WAR.
. Нажмите ОК, чтобы закрыть диалоговое окно 'Свойства проекта'.
При сборке проекта ``HelloWebApplet`` с помощью команды 'Выполнить > Собрать проект (HelloWebApplet)' главного меню IDE JAR-файл апплета создается в исходном проекте ``HelloApplet`` и упаковывается в WAR-файл проекта ``HelloWebApplet`` . Он также добавляется в папку ``build/web`` . Следить за процессом можно в окне "Результат", а конечный результат можно посмотреть в окне "Файлы".
[.feature]
--
image:images/helloapplet-jar-in-files-small.png[role="left", link="images/helloapplet-jar-in-files.png"]
--
=== Создание и запуск файла JSP или HTML
1. Выполните одно из следующих действий.
* Если необходимо встроить апплет в файл JSP, дважды нажмите стандартный файл ``index.jsp`` в окне "Свойства". Этот файл создается средой IDE при создании веб-проекта. Файл открывается в редакторе исходного кода.
* Если необходимо внедрить апплет в файл HTML, щелкните правой кнопкой мыши узел проекта HelloWebApplet и выберите 'Создать' > 'Другие' в контекстном меню. В области "Категории" выберите "Web". В области "Типы файлов" выберите HTML. Нажмите кнопку "Далее". Укажите название файла HTML, выберите папку Web (она расположена в нужном месте) и нажмите "Завершить".
. Встройте апплет в файл, добавив следующий тег апплета в любом месте в рамках тегов ``<body>`` ``</body>`` .
* В файле HTML: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar"></applet>`` #
* В файле JSP: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar" width="600" height="480"/>`` #
*Примечания.*
* При добавлении апплета в файл HTML в рамках этой учебной задачи можно игнорировать значок подсказки, который появляется в левом поле.
* ``org.me.hello.MyApplet`` - полное имя класса апплета.
* ``HelloApplet.jar`` - файл JAR, содержащий апплет.
. В окне "Проекты" щелкните узел JSP или HTML правой кнопкой мыши и в контекстном меню выберите "Выполнить файл".
Сервер развертывает файл JSP или HTML в браузере среды IDE, установленном по умолчанию.
Вы должны получить результат, аналогичный показанному на иллюстрации (после того как вы разрешили запуск приложения нажатием на кнопку 'Выполнить' в диалоговом окне 'Предупреждение системы безопасности'):
[.feature]
--
image:images/appletinbrowser-small.png[role="left", link="images/appletinbrowser.png"]
--
В случае работы с формами апплетов ваш результат будет похож на следующий:
image::images/movie-magic-quiz-html.png[]
link:/about/contact_form.html?to=3&subject=Feedback:%20Introduction%20to%20Developing%20Applets[+Отправить отзыв по этому учебному курсу+]