// 
//     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.
//

= Integrando um Applet em uma Aplicação Web
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Integrando um Applet em uma Aplicação Web - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Integrando um Applet em uma Aplicação Web

Um applet é um programa escrito na linguagem de programação Java que pode ser incluído em uma página HTML, de forma semelhante a que uma imagem é incluída em uma página. A aplicação que você constrói neste tutorial mostra como construir e implantar applets no IDE.

*Observação: *embora não haja modelos de projeto que sejam especificamente destinados a criar applets no IDE, você pode facilmente desenvolvê-los em um projeto Java e encapsulá-los em um projeto Web, como mostrado neste tutorial.


image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]


*Para acompanhar este tutorial, você precisa dos recursos e softwares a seguir.*

|===
|Software ou Recurso |Versão Necessária 

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

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+JDK (Java Development Kit)+] |versão 7 ou 8 

|GlassFish Server Open Source Edition 
_ou_ 
Contêiner do servlet Tomcat |3.x ou 4.x
_ _ 
versão 7.x ou 8.x 
|===


== Criando ou Importando um Arquivo de Código Fonte de um Applet

Nesta seção, você criará seu primeiro applet. Possivelmente, você já tem um applet e, nesse caso, você pode usar as instruções abaixo para importá-lo para o IDE.


=== Crie o projeto Java do zero ou a partir de códigos-fonte existentes

1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N). Em Categorias, selecione Java.
2. Selecione uma das seguintes opções:
* Se você estiver criando um novo código-fonte de applet, selecione Biblioteca de Classe Java em Projetos. Clique em Próximo.
* Se você quiser importar um arquivo de código-fonte de applet, selecione Projeto Java com Códigos-Fonte existentes. Clique em Próximo. Especifique a localização do arquivo na caixa de texto Pasta de Pacotes de Códigos-Fonte.

[start=3]
. Em Nome do Projeto, Digite  ``HelloApplet`` . Altere o Local do Projeto para qualquer pasta do computador.

[start=4]
. Clique em Finalizar. Se você tiver importado um arquivo de código-fonte do applet, <<runanddebug,execute-o>>.


=== Crie o arquivo de código-fonte do applet

1. Clique com o botão direito do mouse no projeto HelloApplet e selecione Propriedades para abrir a janela Propriedades.
2. Selecione o Formato de Código-Fonte / Binário desejado para o projeto e clique em OK.

*Observação:* Por exemplo, se selecionar JDK 6, o applet poderá não ser executado em máquinas que tenham uma versão mais antiga do plug-in JRE ou do browser Java.


[start=3]
. Clique com o botão direito do mouse no nó do projeto HelloApplet na janela Projetos e selecione Novo > Outro (Ctrl-N).

[start=4]
. Em Categorias, selecione Java. Em Tipos de Arquivos, selecione Applet.

Como alternativa, se você quiser criar visualmente o applet, selecione Forms de GUI do Swing > Form JApplet.

Clique em Próximo.


[start=5]
. Em Nome da Classe, Digite  ``MyApplet`` . Em Pacote, digite  ``org.me.hello`` .

[start=6]
. Clique em Finalizar.

O IDE criará o arquivo de código-fonte do applet no pacote especificado. O arquivo de código-fonte do applet será aberto no editor de Código-fonte.


[start=7]
. Defina a classe do seu applet, copiando e colando o seguinte código sobre o código default existente:

[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);
         }
     }
                    
----

Como alternativa, se você estiver criando um Form de Applet, use o documento link:../java/quickstart-gui.html[+Criando uma GUI Swing no NetBeans IDE+] para criar algo como o seguinte:

image::images/movie-magic-quiz-design.png[]

Para obter informações detalhadas sobre como escrever applets, consulte a seção link:http://download.oracle.com/javase/tutorial/deployment/applet/index.html[+Applets+] do Tutorial do Java^TM^.


== Executando um Arquivo de Código-Fonte do Applet

O applet que você criou pode ser executado a partir do IDE. Esta seção mostra como fazê-lo.


=== Construa e execute o arquivo de código-fonte do applet

Clique com o botão direito do mouse no nó do arquivo MyApplet.java na janela Projetos e selecione Executar Arquivo no menu de contexto. O arquivo acionador  ``MyApplet.html`` , com o applet incorporado, é criado na pasta  ``build`` , que você poderá ver se alternae para a janela Arquivos (Ctrl-2):

image::images/built-project-files.png[]

O applet é acionado no Visualizador de Applets:

image::images/appletviewer.png[]

Os forms do applet também são exibidos no Visualizador de Applets:

image::images/movie-magic-quiz.png[]


== Incorporando um Applet em uma Aplicação Web

Seu applet está concluído. Agora você precisa torná-lo disponível para o usuário. Para fazê-lo, crie uma aplicação Web, coloque o JAR do applet em seu classpath, e adicione uma tag do applet ao arquivo HTML da aplicação Web.


=== Criar o projeto Web

1. Escolha Arquivo > Novo Projeto.
2. Na categoria Java Web, selecione Aplicação Web. Clique em Próximo.
3. Em Nome do Projeto, digite  ``HelloWebApplet`` .
4. Altere o Local do Projeto para qualquer pasta do computador. Clique em Próximo.
5. Selecione o servidor de destino. Clique em Finalizar.


=== Adicione o arquivo JAR do applet ao projeto Web

Quando quiser incluir um arquivo JAR do applet em um projeto Web, você poderá fazê-lo adicionando o projeto Java que contém o arquivo JAR, ou adicionando o próprio arquivo JAR. Embora a escolha seja sua, observe que quando adiciona o projeto Java ao projeto Web, você permite que o IDE construa o applet sempre que você constrói a aplicação Web. Portanto, quando você modifica o applet no projeto Java, o IDE constrói uma nova versão do applet sempre que o projeto Web é construído. Por outro lado, se o arquivo JAR do applet não estiver em um projeto do NetBeans IDE, o código-fonte do applet não será recriado quando você construir o projeto web.

*Observação:* neste ponto, se você estiver usando o projeto  ``HelloApplet``  no IDE, não há um arquivo  ``HelloApplet.jar`` . Isso é normal. O arquivo  ``HelloApplet.jar``  será construído quando você construir o projeto  ``HelloWebApplet`` .

1. Na janela Projetos, clique com o botão direito do mouse no nó do projeto HelloWebApplet e selecione Propriedades no menu contextual.
2. Selecione a categoria Encapsulamento.
3. Selecione uma das seguintes opções:
* Se o applet estiver em um projeto Java, clique em Adicionar Projeto e localize a pasta que contém o projeto Java. Clique em Adicionar Jar/Pasta.

*Observação.* Os projetos do IDE são marcados pelo ícone de projeto do NetBeans IDE.

* Se estiver usando um arquivo JAR do applet que não está no projeto IDE, clique em Adicionar Arquivo/Pasta e localize a pasta que contém o arquivo JAR. Clique em Escolher.

[start=4]
. Confirme se o JAR que contém o arquivo do código-fonte do applet está listado na tabela na janela Propriedades do Projeto. Clique em OK.

Por default, o arquivo JAR do applet será copiado para a biblioteca da página Web da aplicação Web, que é a pasta  ``build/web `` . A pasta  ``build/web `` é o diretório-raiz da aplicação e é exibido como " ``/`` " no Caminho na coluna WAR da tabela. Você pode modificar a localização do applet no WAR digitando uma nova localização para o applet no Caminho na coluna WAR.


[start=5]
. Clique em Fechar para fechar a janela Propriedades do Projeto.

Quando você constrói o projeto  ``HelloWebApplet``  escolhendo Executar > Construir Projeto (HelloWebApplet) no menu principal do IDE, o arquivo JAR do applet é gerado no projeto  ``HelloApplet``  original e é encapsulado no arquivo WAR do projeto  ``HelloWebApplet`` . Ele também é adicionado à pasta  ``build/web`` . Você pode seguir este processo na janela de Saída e ver os resultados na janela Arquivos.

[.feature]
--
image:images/helloapplet-jar-in-files-small.png[role="left", link="images/helloapplet-jar-in-files.png"]
--


=== Crie e execute o arquivo JSP ou o arquivo HTML

1. Selecione uma das seguintes opções:
* Se você quiser incorporar o applet em um arquivo JSP, clique duas vezes no arquivo  ``index.jsp``  default na janela Projetos. Esse arquivo é criado pelo IDE quando você cria um projeto Web. Ele será aberto no Editor de Código-fonte.
* Se você quiser incorporar o applet em um arquivo HTML, clique com o botão direito do mouse no nó do projeto HelloWebApplet e selecione Novo > Outro a partir do menu de contexto. Em Categorias, selecione Web. Em Tipos de Arquivos, selecione HTML. Clique em Próximo. Forneça um nome para seu arquivo HTML, selecione a pasta Web como sua localização e clique em Finalizar.

[start=2]
. Incorpore o applet no arquivo, adicionando a seguinte tag de applet em qualquer local entre as tags  ``<body>``  ``</body>``  do arquivo:

* Em um arquivo HTML: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar"></applet>``  #
* Em um arquivo JSP: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar" width="600" height="480"/>`` #

*Observações.*

* Para este tutorial você pode ignorar o glifo de dica na margem esquerda se estiver adicionando o código do applet em um arquivo HTML.
*  ``org.me.hello.MyApplet``  é o nome de classe completo para seu applet.
*  ``HelloApplet.jar``  é o arquivo JAR que contém o applet.

[start=3]
. Clique com o botão direito do mouse no nó JSP ou no nó HTML na janela Projetos e selecione Executar Arquivo no menu de contexto.

O servidor implanta o arquivo JSP ou o arquivo HTML no browser default do IDE.

Você deve ver algo semelhante à ilustração abaixo (após permitir a execução da aplicação, clicando em Executar na caixa de diálogo Advertência de Segurança).

[.feature]
--
image:images/appletinbrowser-small.png[role="left", link="images/appletinbrowser.png"]
--

Para forms do applet, será preciso ver algo semelhante ao seguinte:

image::images/movie-magic-quiz-html.png[]


link:/about/contact_form.html?to=3&subject=Feedback:%20Introduction%20to%20Developing%20Applets[+Enviar Feedback neste Tutorial+]


