corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Habilitando o Java Web Start no NetBeans IDE

Seguindo as etapas neste tutorial, você aprenderá a configurar seu aplicativo para que ele possa ser implantado utilizando o Java Web Start. O Java Web Start é uma tecnologia que é utilizada para executar aplicativos Java a partir de um navegador da web com apenas um clique. Em resumo, o Java Web Start é apenas outra forma de como é possível implantar aplicativos Java.

Neste tutorial, utilizamos um aplicativo Java simples, um conversor, que converte as medições de distâncias entre as unidades métricas e a dos EUA. O código para este aplicativo de amostra será disponibilizado para download e será necessário configurar as definições do projeto para poder iniciá-lo utilizando o Java Web Start. Projeto Kenai, que fornece as capacidades de colaboração para os desenvolvedores, é utilizado neste tutorial como um exemplo de um servidor da Web remoto ao qual é possível carregar arquivos do aplicativo. É possível utilizar qualquer outro local remoto para carregar os arquivos do aplicativo.

Este tutorial leva aproximadamente 20 minutos para ser completado.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.7, 6.8 e 6.9

Para concluir este tutorial, são necessários o software e os recursos apresentados na tabela a seguir.

Software ou recurso Versão necessária
NetBeans IDE Versão 6.7, 6.8 ou 6.9
Java Development Kit (JDK)

versão 6

Abrindo um projeto

Primeiro, é necessário abrir um projeto IDE com o aplicativo Converter. O código-fonte do aplicativo já está empacotado como um projeto NetBeans IDE, portanto, basta abri-lo no IDE.

O código-fonte para a demonstração Converter é originalmente fornecido no tutorial Java. Consulte a seção Utilizando componentes Swing do tutorial Java para aprender como escrever este pequeno aplicativo. Neste tutorial, você aprenderá a configurar suas configurações de projeto para que este aplicativo Java possa ser iniciado em um navegador Web.

  1. Baixe do arquivo zip que contém a demonstração do aplicativo Convertor empacotado como um projeto do NetBeans IDE.
    Descompacte-o em qualquer localização do sistema.
  2. No IDE, escolha Arquivo > Abrir projeto, a partir do menu principal.
    O projeto ConverterPrj é aberto na janela Projetos. Você pode expandir os nós do projeto para visualizar os arquivos de código-fonte.

Imagem mostrando o conteúdo do ConverterPrj.

Configurando o projeto para habilitar o Java Web Start

Com o Java Web Start, o usuário pode iniciar o aplicativo Java clicando no link HTML para um arquivo JNLP para este aplicativo dentro do navegador Web. O arquivo JNLP, que é um arquivo de configuração especial, instrui o Java Web Start para baixar, fazer o cache e executar o aplicativo Java. Para executar aplicativos com o Java Web Start, basta ter uma versão compatível do Java Runtime Environment (JRE) instalado na máquina cliente. A instalação do Java Development Kit (JDK) não é necessária.

Para habilitar seu aplicativo Java para ser executado com o Java Web Start, é preciso configurar as propriedades sobre como o IDE deveria ser incorporado no projeto. Quando o Java Web Start é habilitado nas propriedades do projeto, o IDE cria automaticamente um arquivo JNLP e uma página HTML com o link para o arquivo JNLP, junto com o arquivo JAR.

Configurando o projeto para habilitar o Java Web Start

Primeiro, configuramos o projeto para torná-lo habilitado para o Java Web Start e testamos localmente sua execução.

  1. Clique com o botão direito do mouse no nó do projeto ConverterPrj e escolha Propriedades.
  2. Em Categorias, escolha Web Start e selecione a caixa de verificação Habilitar o Web Start.
  3. Escolha a opção Execução local na lista suspensa Código-base, já que primeiro iremos executar o aplicativo localmente.
    O campo Visualizar código-base mostra o caminho para os arquivos do aplicativo local.
  4. Assegure que a caixa de verificação Autoassinado esteja marcada.
    O arquivo do aplicativo JAR será assinado por um certificado gerado automaticamente quando o projeto for construído. Com o certificado autoassinado, o aplicativo será capaz de acessar os mesmos recursos a partir do computador como um aplicativo regular que é executado localmente. Por exemplo, o certificado autoassinado permite que um aplicativo acesse arquivos locais e a rede.
  5. (Opcional). Na caixa de diálogo Propriedades do projeto, selecione o painel Aplicativos e altere o título do aplicativo e o nome do fornecedor.
  6. Clique em OK para fechar a caixa de diálogo Propriedades do projeto.

Imagem mostrando as propriedades do ConverterPrj.

Compilando e executando o aplicativo Java WebStart a partir do IDE

Para compilar e executar localmente o aplicativo Java Web Start:

  1. clique com o botão direito do mouse no nó do projeto ConvertePrj e selecione Definir como projeto principal.
  2. Escolha Executar > Executar projeto principal ou pressione F6.
    O IDE compila o código-fonte e é possível ver a tela de splash indicando que o Java está sendo iniciado e a janela de aviso perguntando se o aplicativo assinado pode ser executado.
  3. Selecione a caixa de verificação para definir o conteúdo como confiável e clique em Executar na janela de aviso.
    O aplicativo Converter é iniciado.

Imagem mostrando o aplicativo Converter.

Explorando os arquivos Java Web Start

Vamos agora examinar de perto os arquivos Java Web Start que foram criados pelo IDE durante o processo de construção.

Para visualizar os arquivos, abra a janela Arquivos no IDE e expanda a pasta dist. Para o Java Web Start, os seguintes dois arquivos adicionais foram criados:

  • launch.jnlp: este é um arquivo XML com elementos especiais e atributos que instruem os navegadores sobre como executar o aplicativo. JNLP representa o Java Network Launching Protocol. Os atributos dos arquivos JNLP podem incluir a versão de especificação JNLP, o título do aplicativo, o nome do fornecedor, um link para o aplicativo JAR, etc.
  • launch.html: esta é uma página HTML automaticamente gerada, que possui um link para o arquivo JNLP. Os usuários clicam nesse link para iniciar os aplicativos através do Java Web Start. Esse arquivo HTML gerado também possui uma referência cancelada com comentário para o Java Deployment Toolkit (deployJava.js) publicamente disponível, que fornece funções JavaScript para poder evitar problemas de compatibilidade do navegador. É possível encontrar aqui mais informações sobre Java Deployment Toolkit .

    É possível tentar o seguinte: fora do IDE, vá para o arquivo launch.html no sistema, abra-o em seu navegador e clique no link para iniciar o aplicativo de demonstração Converter.

Imagem mostrando os arquivos criados para o aplicativo Converter

Executando o aplicativo a partir de uma localização remota

Após ter verificado que o aplicativo foi iniciado com êxito com o Java Web Start a partir do código-fonte local, vamos carregá-lo em uma localização remota e iniciá-lo a partir daquela localização.

Este tutorial mostra como carregar o aplicativo no Projeto Kenai, que fornece um ambiente de colaboração para desenvolvedores e permite que os usuários hospedem e compartilhem código e projetos de código-fonte aberto. Se você decidir seguir nossas instruções sobre como carregar no Kenai, será necessário ter uma conta de usuário e um projeto Kenai. No entanto, também é possível decidir carregar seu aplicativo em qualquer outro servidor Web.

Nota: para deployment de aplicativos com o Java Web Start na Web, o servidor Web que estiver sendo utilizado deve ser capaz de manipular arquivos JNLP. O servidor Web deve ser configurado para reconhecer os arquivos JNLP como aplicativos, ou seja, o tipo MIME para o JNLP deve ser adicionado na configuração do servidor Web. Caso contrário, os arquivos com a extensão JNLP serão tratados como arquivos de texto comuns. Para obter mais informações sobre a configuração do servidor Web, consulte o Guia do Java Web Start.

Modificando o arquivo JNLP

Para iniciar o aplicativo a partir da Web, é preciso fornecer um link para o arquivo de código-fonte dos aplicativos na Web no arquivo JNLP.

  1. Clique com o botão direito do mouse no nó do projeto ConvertePrj, escolha Propriedades e selecione Web Start em Categorias.
  2. Escolha definida pelo usuário como o Código-base.
  3. No campo Visualizar o código-base, insira o URL onde estará carregando os arquivos de código-fonte.
    Por exemplo, http://kenai.com/projects/netbeans-java-docs/downloads/download/converter/

    Em nosso exemplo, carregaremos os arquivos do aplicativo no projeto netbeans-java-docs no Kenai.
  4. Clique em OK na janela Propriedades do projeto.
  5. Clique com o botão direito do mouse no nó ConverterPRJ e escolha Limpar e construir.
    Este comando do IDE exclui todos os arquivos anteriormente compilados e as saídas construídas, recompila seu aplicativo e constrói os arquivos de saída com as configurações atuais.

Carregando os arquivos do código-fonte

Agora nós iremos carregar os arquivos do código-fonte em um projeto Kenai e executar o aplicativo a partir do Kenai. Observe que todas as credenciais de usuário e nomes de projeto referenciados nesta seção deveriam ser substituídos por seus dados pessoais.

  1. Faça o logon no Kenai.com e vá à área de download do seu projeto.
    Em nosso caso, o título do projeto é "NetBeans IDE Documentation Area" e o link para o download do projeto é http://kenai.com/projects/netbeans-java-docs/downloads/
  2. Carregue os seguintes arquivos locais a partir da pasta dist de seu projeto para a área Downloads de seu projeto: ConverterPrj.jar, launch.html e launch.jnlp.
    A figura abaixo mostra a área de download para a área do projeto NetBeans IDE Documentation. Imagem mostrando a área de download para a área do projeto NetBeans IDE Documentation no Kenai.
  3. Agora, execute o aplicativo. Em uma janela do navegador, insira o URL para o arquivolaunch.html. O aplicativo Converter se inicia com o Java Web Start.

Resumo

Neste curto tutorial, mostramos como tornar com facilidade um aplicativo Java implantável através da Web utilizando o NetBeans IDE. Essa é apenas outra forma para poder implantar aplicativos Java.

Como um exemplo de um servidor remoto onde hospedar o aplicativo, utilizamos o kenai.com.


Consulte também

Para obter mais informações sobre como utilizar o Java Web Start, consulte os seguintes recursos:

Para obter mais informações sobre o projeto Kenai e sua integração com o NetBeans IDE, consulte: