corner imagecorner image
FeaturesPluginsDocs & SupportCommunityPartners

Integrando um miniaplicativo em uma aplicação Web

Um miniaplicativo é 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. O aplicativo que você constrói neste tutorial mostra como construir e implantar miniaplicativos no IDE.

Observação: Embora não haja modelos do projeto que sejam especificamente destinados a criar miniaplicativos no IDE, você pode facilmente desenvolvê-los em um projeto Java e empacotá-los em um projeto da Web, como mostrado neste tutorial.

Conteúdo

 O conteúdo desta página se aplica ao IDE NetBeans 6.0

Para seguir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou recurso Versão necessária
NetBeans IDE Versão 6.1 ou
versão 6.0
Java Development Kit (JDK) Versão 6 ou
versão 5

Criando ou importando o arquivo-fonte de um miniaplicativo

Nesta seção, você cria seu primeiro miniaplicativo. Possivelmente, você já possui um miniaplicativo 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. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Geral.
  2. Escolha uma das seguintes posições:
    • Se você estiver criando um novo código-fonte de miniaplicativo, selecione Biblioteca de classe Java em Projetos. Clique em Próximo.
    • Se você quiser importar um arquivo-fonte de aplicativo, 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.
  3. Em Nome do projeto, digite HelloApplet. Altere Local do projeto para qualquer pasta do computador.
  4. Clique em Terminar. Se você importou um código-fonte de miniaplicativo, execute-o e depure-o.

Crie o código fonte do miniaplicativo

  1. Clique com o botão direito do mouse no nó do projeto HelloApplet na janela Projetos e selecione Novo arquivo/Pasta (Ctrl-N).
  2. Em Categorias, selecione Classes Java. Em Tipos de arquivos, selecione miniaplicativo.

    Como alternativa, se você quiser criar visualmente o miniaplicativo, selecione Formulários de GUI Java > Formulários AWT > Formulário de miniaplicativo.

    Clique em Próximo.

  3. Em Nome da classe, digite MyApplet. Em Pacote, digite org.me.hello.
  4. Clique em Terminar.

    O IDE cria o arquivo-fonte do miniaplicativo no pacote especificado. O arquivo-fonte do miniaplicativo se abre no editor de código-fonte.
  5. Defina a classe do seu miniaplicativo, copiando e colando o código seguinte sobre o código padrão existente:
         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);
             }
         }
                        

    Como alternativa, se você estiver criando um Formulário de miniaplicativo, use o documento Criando uma GUI Swing no NetBeans IDE para criar algo como o seguinte:

    Design Formulário de miniaplicativo

    Para obter informações detalhadas sobre como escrever miniaplicativos, consulte a seção Miniaplicativos do Tutorial JavaTM.


Executando e depurando um arquivo-fonte de miniaplicativo

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

Construa e execute o código-fonte do miniaplicativo

  1. Na janela Projetos, clique com o botão direito do mouse no nó do projeto HelloApplet e escolha Construir projeto no menu contextual.
  2. O arquivo HelloApplet.jar é criado na pasta dist.
  3. Clique com o botão direito do mouse no nó da classe do miniaplicativo na janela Projetos e escolha Executar no menu contextual.

    O arquivo iniciador MyApplet.html, com o miniaplicativo incorporado, é criado na pasta build:

    Visualizar miniaplicativo

    O miniaplicativo é iniciado no visualizador de miniaplicativos:

    Visualizar miniaplicativo

    Os formulários do miniaplicativo também são exibidos no visualizador de miniaplicativos:

    design


    Depure o código-fonte do miniaplicativo modificando seus parâmetros

    O arquivo iniciador MyApplet.html da pasta build será sobrescrito sempre que o miniaplicativo for executado ou depurado. Portanto, não modifique o arquivo iniciador da pasta build. Em vez disso, use o procedimento seguinte:

    1. Abra a janela Arquivos (Ctrl-2).
    2. Copie o arquivo iniciador MyApplet.html da pasta build para o pacote em que a classe do miniaplicativo reside na pasta src (nesse caso, para org.me.hello). Certifique-se de que o arquivo iniciador MyApplet.html tenha o mesmo nome da classe do miniaplicativo.
    3. Edite o arquivo iniciador MyApplet.html, se necessário.

      Quando o projeto é construído, o arquivo iniciador MyApplet.html.html é copiado da pasta src para a pasta build.

      Dica: Um arquivo iniciador será criado pelo IDE quando um miniaplicativo for executado ou depurado. Se você copiá-lo na pasta src para edição, ele será automaticamente incluído no arquivo JAR quando o projeto for construído. Normalmente, você não precisa incluir esse arquivo quando empacota seu aplicativo. Exclua o arquivo iniciador do arquivo JAR, clicando com o botão direito do mouse no projeto, escolhendo Propriedades, clicando em Empacotamento, e adicionando uma expressão para excluir arquivos iniciadores como MyApplet.html.


Incorporando um miniaplicativo em uma aplicação Web

Seu miniaplicativo 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 miniaplicativo em seu classpath, e adicione uma marca do miniaplicativo ao arquivo HTML da aplicação Web.

Criar o projeto da Web

  1. Escolha Arquivo > Novo projeto. Em Categorias, selecione Web. Em Projetos, selecione Aplicação Web. Clique em Próximo.
  2. Em Nome do projeto, digite HelloWebApplet. Altere Local do projeto para qualquer pasta do computador. Clique em Terminar.

Adicione o arquivo JAR do miniaplicativo no projeto da Web

Quando deseja incluir um arquivo JAR do miniaplicativo em um projeto da Web, você pode 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 da Web, você permite que o IDE construa o miniaplicativo sempre que você constrói a aplicação Web. Portanto, quando você modifica o miniaplicativo no projeto Java, o IDE constrói uma nova versão do miniaplicativo sempre que o projeto da Web é construído. Por outro lado, se o arquivo JAR do miniaplicativo não estiver em um projeto Java do NetBeans IDE 5.x, o código-fonte do miniaplicativo não é reconstruído quando você constrói o projeto da Web.

  1. Na janela Projetos, clique com o botão direito do mouse no nó HelloWebApplet e escolha Propriedades no menu contextual.
  2. Escolha um dos seguintes:
    • Se o arquivo JAR do miniaplicativo estiver em um projeto Java, clique em Empacotamento e, em seguida, clique em Adicionar projeto. Vá para e selecione a pasta que contém o projeto Java. Observe que os projetos do IDE são marcados pelo ícone de projeto do NetBeans IDE.
    • Se o arquivo JAR do miniaplicativo não estiver em um projeto do IDE, clique em Empacotamento e, em seguida, clique em Adicionar JAR/pasta. Vá para e selecione a pasta que contém o arquivo JAR.
  3. O arquivo JAR que contém o arquivo de código-fonte do miniaplicativo é listado em uma tabela na parte inferior da caixa de diálogo Propriedades do projeto.

  4. Opcionalmente, você pode digitar uma localização para o miniaplicativo no caminho da tabela na coluna WAR. Por padrão, o arquivo JAR do miniaplicativo será copiado na raiz do documento da aplicação Web, que é a pasta build/web (o nível mais elevado da estrutura de arquivos da aplicação Web). Clique em OK.

    Quando você constrói o projeto, o arquivo JAR do miniaplicativo é empacotado no arquivo WAR do projeto na pasta dist. Ele também é adicionado à pasta build/web. Para obter detalhes, veja a ilustração abaixo.

    Visualizar miniaplicativo

Crie e execute o arquivo JSP ou o arquivo HTML

  1. Escolha um dos seguintes:
    • Se você quiser incorporar o miniaplicativo em um arquivo JSP, clique duas vezes no arquivo index.jsp padrão na janela Projetos. Esse arquivo é criado pelo IDE quando você cria um projeto da Web. Ele é aberto no editor de código-fonte.
    • Se você quiser incorporar o miniaplicativo em um arquivo HTML, clique com o botão direito do mouse no nó do projeto HelloWebApplet e escolha Novo > Arquivo/Pasta no menu contextual. Em Categorias, selecione Web. Em Tipos de arquivos, selecione HTML. Clique em Próximo. Dê um nome para o seu arquivo HTML e clique em Terminar.
  2. Incorpore o miniaplicativo no arquivo, adicionando a seguinte marca de miniaplicativo em qualquer local entre as marcas <body></body> do arquivo:
    <applet code="org.me.hello.MyApplet" archive="HelloApplet.jar"/> 
    • org.me.hello.MyApplet é o nome de classe completo do miniaplicativo
    • HelloApplet.jar é o arquivo JAR que contém o miniaplicativo
  3. Clique com o botão direito do mouse no nó JSP ou no nó HTML na janela Projetos e escolha Executar arquivo no menu contextual.

    O servidor implanta o arquivo JSP ou o arquivo HTML no navegador padrão do IDE.

    Você deve ver algo semelhante à ilustração abaixo:

    Visualizar miniaplicativo

    Para formulários de miniaplicativo, você deve ver algo semelhante ao seguinte (somente testado com êxito no FireFox):

    design

    Observe que os miniaplicativos são executados na máquina virtual do navegador da Web padrão do IDE. O IDE usa uma máquina virtual diferente e, portanto, os miniaplicativos não são incluídos em sessões de depuração do aplicativo da Web. Depure o miniaplicativo dentro do projeto Java, como explicado acima.



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