| // |
| // 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 с существующим исходным кодом". Нажмите кнопку "Далее". Укажите местоположение файла в текстовом поле "Папка с исходными файлами". |
| |
| [start=3] |
| . В поле "Имя проекта" введите ``HelloApplet`` . В области "Расположение проекта" укажите любую папку на своем компьютере. |
| |
| [start=4] |
| . Нажмите кнопку "Завершить". Если файл исходного кода апплета был импортирован, <<runanddebug,запустите его>>. |
| |
| |
| === Создание файла исходного кода апплета |
| |
| 1. Нажмите название проекта HelloApplet правой кнопкой мыши и выберите пункт "Свойства", при этом откроется окно "Свойства". |
| 2. Выберите нужный формат исходных/двоичных файлов для проекта и нажмите ОК. |
| |
| *Примечание.* Если выбрана версия JDK 1.6, апплет может не запускаться на компьютерах, на которых установлена предыдущая версия JRE или подключаемого модуля Java для браузера. |
| |
| |
| [start=3] |
| . Нажмите узел HelloApplet в окне "Проекты" и выберите "Новый" > "Другое" (Ctrl-N). |
| |
| [start=4] |
| . В области "Категории" выберите "Java". В области "Типы файлов" выберите "Апплет". |
| |
| Если же нужно использовать визуальные средства для разработки апплета, выберите "Формы Swing GUI" > "Форма JApplet". |
| |
| Нажмите кнопку "Далее". |
| |
| |
| [start=5] |
| . В области "Имя класса" введите ``MyApplet`` . В поле "Пакет" введите ``org.me.hello`` . |
| |
| [start=6] |
| . Нажмите кнопку "Завершить". |
| |
| Среда IDE создает исходный файл апплет в указанном пакете. Исходный файл апплета открывается в редакторе исходного кода. |
| |
| |
| [start=7] |
| . Определите класс своего апплета, заменив существующий стандартный код следующим кодом: |
| |
| [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. Нажмите 'Выбрать'. |
| |
| [start=4] |
| . Убедитесь, что JAR с исходным файлом апплета отображается в таблице в окне 'Свойства проекта'. Нажмите кнопку "ОК". |
| |
| По умолчанию файл JAR апплета будет скопирован в библиотеку страницы веб-приложения (папку ``build/web `` ). Папка ``build/web `` является корневым каталогом приложения и отображается в таблице как " ``/`` " в переменной Path в столбце WAR. Вы можете изменить расположение апплета в WAR. Для этого введите новое расположение апплета в переменной Path в столбце WAR. |
| |
| |
| [start=5] |
| . Нажмите ОК, чтобы закрыть диалоговое окно 'Свойства проекта'. |
| |
| При сборке проекта ``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 (она расположена в нужном месте) и нажмите "Завершить". |
| |
| [start=2] |
| . Встройте апплет в файл, добавив следующий тег апплета в любом месте в рамках тегов ``<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, содержащий апплет. |
| |
| [start=3] |
| . В окне "Проекты" щелкните узел 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[+Отправить отзыв по этому учебному курсу+] |
| |
| |