corner imagecorner image
FeaturesPluginsDocs & SupportCommunityPartners

Интеграция апплета в веб-приложение

Апплет – это программа, написанная на языке программирования Java и предназначенная для вставки в страницу HTML, аналогично добавлению в страницу изображения. Приложение, создаваемое в этом руководстве, позволяет ознакомиться с процессом сборки и развертывания апплетов в среде IDE.

Примечание: Шаблонов проекта, специально разработанных для создания апплетов в среде IDE, не существует, однако их можно разрабатывать в обычном проекте Java и упаковывать в веб-проект в соответствии с указаниями в этом руководстве.

Содержание

Содержимое на этой странице относится к среде IDE NetBeans 6.0

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

Программное обеспечение или ресурс Требуемая версия
Среда IDE NetBeans версия 6.1 или
версия 6.0
Комплект для разработчика на языке Java (JDK) версия 6 или
версия 5

Создание или импорт исходного файла апплета

В этом разделе описана процедура создания первого апплета. Возможно, уже имеется готовый апплет; в этом случае можно импортировать его в среду IDE с помощью последовательности действий, приведенной ниже.

Создание проекта Java "с нуля" или из существующих исходных кодов

  1. Выберите "File > New Project" (Ctrl-Shift-N). В области "Categories" выберите "General".
  2. Выберите один из следующих вариантов:
    • Если создается новый исходный файл апплета, выберите "Java Class Library" в "Projects". Нажмите кнопку "Next".
    • Если требуется импорт исходного файл апплета, выберите "Java Project with Existing Sources". Нажмите кнопку "Next". Укажите расположение файла в текстовом поле "Source Packages Folder".
  3. В поле "Project Name" введите HelloApplet. В поле "Project Location" укажите любую папку на компьютере.
  4. Нажмите кнопку "Finish". Если исходный файл апплета был импортирован, запустите его и выполните отладку.

Создание исходного файла апплета

  1. Щелкните правой кнопкой мыши узел проекта "HelloApplet" в окне "Projects" и выберите "New File/Folder" (Ctrl-N).
  2. В области "Categories" выберите "Java Classes". В области "File Types" выберите "Applet".

    В качестве альтернативы, если предполагается визуальное проектирование апплета, выберите "Java GUI Forms > AWT Forms > Applet Form".

    Нажмите кнопку "Next".

  3. В поле "Under Class Name" введите MyApplet. В поле "Package" введите org.me.hello.
  4. Нажмите кнопку "Finish".

    В среде IDE автоматически создается исходный файл апплета в указанном пакете. Исходный файл апплета открывается в редакторе исходного кода.
  5. Определите класс апплета путем копирования и вставки следующего кода вместо существующего кода по умолчанию:
         package org.me.hello;
    
         import java.applet.Applet;
         import java.awt.Graphics;
    
         public class MyApplet extends Applet {
             public void paint(Graphics g) {
                 g.drawString("Hello applet!", 50, 25);
             }
         }
                        

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

    Проект формы апплета

    Для получения подробной информации о написании апплетов см. раздел Applets руководства по JavaТМ.


Запуск и отладка исходного файла апплета

Запуск и отладку созданного апплета можно выполнять в среде IDE. В этом разделе приводится соответствующая процедура.

Сборка и запуск исходного файла апплета

  1. Щелкните правой кнопкой мыши узел проекта в окне "Projects" и выберите "Build Project" из контекстного меню.
  2. В dist папке создается файл HelloApplet.jar.
  3. Щелкните правой кнопкой мыши узел класса апплета в окне "Projects" и выберите "Run File" из контекстного меню.

    В папке build создается файл средства запуска MyApplet.html с встроенным апплетом:

    Просмотр апплета

    Апплет запускается в программе просмотра "Applet Viewer":

    Просмотр апплета

    В программе просмотра "Applet Viewer" также отображаются формы апплета:

    проект


    Отладка исходного файла апплета посредством изменения его параметров

    Файл средства запуска MyApplet.html в папке build перезаписывается при каждом запуске или отладке апплета. Поэтому файл средства запуска в папке build не следует изменять. Вместо этого используется следующая процедура:

    1. Откройте окно "Files" (Ctrl-2).
    2. Скопируйте файл средства запуска MyApplet.html из папки build в пакет, где располагается класс апплета, в папке src (в данном случае – в org.me.hello). Убедитесь в том, что имя файла средства запуска MyApplet.html совпадает с именем класса апплета.
    3. Затем измените файл средства запуска MyApplet.html в соответствии с имеющимися требованиями.

      При сборке проекта файл средства запуска MyApplet.html копируется из папки src в папку build.

      Рекомендация: Файл средства запуска создается в среде IDE при запуске отладке апплета. Если его скопировать для изменения в папку src, он автоматически добавляется в файл JAR при сборке проекта. Как правило, добавлять этот файл при упаковке приложения не требуется. Для исключения файла средства запуска из файла JAR необходимо щелкнуть правой кнопкой мыши проект, выбрать "Properties", щелкнуть "Packaging" и добавить выражение для исключения файлов средства запуска, таких как MyApplet.html.


Встраивание апплета в веб-приложение

Апплет готов. Теперь необходимо обеспечить его доступность для пользователя. Для этого создается веб-приложение, JAR апплета помещается в путь к классам, и в файл HTML веб-приложения добавляется тег апплета.

Создание веб-проекта

  1. Выберите "File > New Project". В области "Categories" выберите "Web". В области "Projects" выберите "Web Application". Нажмите кнопку "Next".
  2. В поле "Project Name" введите HelloWebApplet. В поле "Project Location" укажите любую папку на компьютере. Нажмите кнопку "Finish".

Добавление файла JAR апплета к веб-проекту

Если требуется включить файл JAR апплета в веб-проект, этого можно добиться путем добавления проекта Java, содержащего файл JAR, либо путем добавления самого файла JAR. Выбор остается за разработчиком, однако следует учитывать, что при добавлении проекта Java к веб-проекту становится возможной автоматическая сборка апплета при сборке веб-приложения. Таким образом, при изменении апплета в проекте Java при каждой сборке веб-проекта осуществляется сборка и новой версии апплета. С другой стороны, если файл JAR апплета не находится в проекте Java среды IDE NetBeans 5.x, исходный файл апплета при сборке веб-проекта не подвергается повторной сборке.

  1. В окне "Projects" щелкните правой кнопкой мыши узел проекта "HelloWebApplet" и выберите пункт "Properties" в контекстном меню.
  2. Выберите один из следующих вариантов:
    • Если файл JAR апплета находится в проекте Java, щелкните "Packaging", а затем "Add Project". Перейдите к папке, содержащей проект Java, и выберите ее. Обратите внимание, что проекты среды IDE отмечены значком проекта среды IDE NetBeans.
    • Если файл JAR апплета не находится в проекте IDE, щелкните "Packaging", а затем "Add JAR/Folder". Перейдите к папке, содержащей файл JAR, и выберите ее.
  3. Файл JAR, содержащий исходный файл апплета, приводится в таблице в нижней части диалогового окна "Project Properties".

  4. Также можно указать расположение апплета в столбце "WAR" таблицы "Path". По умолчанию файл JAR апплета копируется в корень документа веб-приложения, т.е. в папку build/web (высший уровень структуры файлов веб-приложения). Нажмите кнопку "OK".

    При сборке проекта файл JAR апплета упаковывается в файл WAR проекта в папке dist. Он также добавляется в папку build/web. Для получения более подробной информации см. иллюстрацию ниже.

    Просмотр апплета

Создание и выполнение файла JSP или HTML

  1. Выберите один из следующих вариантов:
    • Если апплет требуется встроить в файл JSP, дважды щелкните файл по умолчанию index.jsp в окне "Projects". Этот файл создается в среде IDE при создании веб-проекта. Файл открывается в редакторе исходного кода.
    • Если апплет требуется встроить в файл HTML, щелкните правой кнопкой мыши узел проекта "HelloWebApplet" и выберите "New > File/Folder" из контекстного меню. В области "Categories" выберите "Web". В области "File Types" выберите "HTML". Нажмите кнопку "Next". Присвойте файлу HTML имя и нажмите кнопку "Finish".
  2. Встройте апплет в файл путем добавления следующего тега апплета в любом месте между тегами <body></body> в файле:
    <applet code="org.me.hello.MyApplet" archive="HelloApplet.jar"/> 
    • Полное имя класса апплета – org.me.hello.MyApplet.
    • Апплет содержится в файле JAR HelloApplet.jar.
  3. Щелкните правой кнопкой мыши узел JSP или HTML в окне "Projects" и выберите "Run File" из контекстного меню.

    Файл JSP или HTML развертывается с сервера в обозревателе среды IDE по умолчанию.

    Результат должен быть подобен приведенному ниже:

    Просмотр апплета

    В случае форм апплета результат похож на следующий рисунок (успешное тестирование проведено только в FireFox):

    проект

    Следует отметить, что апплеты выполняются в виртуальной машине веб-обозревателя среды IDE по умолчанию. В среде IDE используется другая виртуальная машина, и поэтому апплеты не добавляются в сеанс отладки веб-приложения. Отладку апплета следует выполнять внутри проекта Java, как описано выше.



Companion
Projects:
MySQL Database Server   GlassFish Community: an Open Source Application Server   Open Solaris  Open JDK: an Open SourceJDK   Mobile & Embedded Community     Sponsored by 
Sponsored by Sun Microsystems