Configurando
Instalar JWS
Se tiver uma Plataforma Java, Standard Edition (Java SE) V5 ou posterior, você já terá o JWS instalado. Se tiver o
Windows, o JWS está instalado em seu diretório inicial Java (por exemplo, C:\Program Files\Java\jre\bin). No Mac OS X,
o JWS reside em Applications/Utilities/Java. Você pode iniciar o console do JWS sem instalar ou executar de fato um
aplicativo JWS.
Ao iniciar o console do JWS, você pode visualizar os aplicativos em seu cache do JWS. No console, você pode iniciar
quaisquer aplicativos JWS que tenham sido instalados, excluí-los do cache ou instalar atalhos nos aplicativos. Para
iniciar o console, digite o seguinte comando, certificando-se de que o Java esteja no caminho:
Após ser iniciado, o visualizador fica parecido com a Figura 1. Você pode não ter nenhum aplicativo instalado se nunca tiver
utilizado o JWS antes.
Figura 1. O Visualizador do Java Web Start
Se você não tiver um Java Runtime Environment (JRE) instalado, faça o download da versão mais recente e instale-a. Desde que seja Java
SE V5 ou posterior, ele vai incluir o JWS.
Configurar Servidor da Web
Na maioria dos casos, o JWS deve ser iniciado automaticamente se você abrir um arquivo JNLP. Se o arquivo JNLP estiver em um
servidor da Web que não tem o arquivo JNLP associado corretamente, é possível fazer o download do arquivo e abri-lo localmente. Eu
enviei o arquivo JNLP por e-mail antes — ainda tendo os recursos localizados na URL no arquivo — e os destinatários
puderam executar o aplicativo com sucesso utilizando o JWS.
Se você estiver configurando um servidor da Web para entregar arquivos JNLP, que é o método de distribuição mais fácil, você vai
precisar incluir o seguinte arquivo de associação:
application/x-java-jnlp-file JNLP
|
Siga a documentação do servidor da Web para configurar a associação MIME corretamente. Se estiver utilizando um ISP,
consulte a documentação do ISP para aprender como você pode incluir o tipo JNLP MIME.
Estrutura do Arquivo JNLP
O arquivo JNLP é um arquivo XML que contém instruções sobre como o JWS fará o download e utilizará seu aplicativo. Ele ajuda a
entender as diferentes partes do arquivo JNLP, portanto, você pode modificá-lo com segurança.
A Listagem 1 mostra um arquivo JNLP básico. Ele possui apenas os elementos absolutamente necessários para distribuir um aplicativo
independente com o JWS.
Listagem 1. Um Arquivo JNLP Básico
<?xml version="1.0" encoding="utf-8"?>
<jnlp spec="1.0+" codebase="http://www.example.com/applications/" href="app.jnlp">
<information>
<title>Application Title</title>
<vendor>Application Vendor</vendor>
<homepage href="http://www.example.com" />
<description>This is an application.</description>
</information>
<security>
<all-permissions />
</security>
<!-- The name of the main class to execute. -->
<application-desc main-class="
com.example.MyMainClass">
</application-desc>
<resources>
<jar href="exampleApp.jar" />
</resources>
</jnlp>
|
O exemplo na Listagem 1 diria ao JWS para fazer o download do arquivo exampleApp.jar a partir da URL. A URL completa seria
http://www.example.com/applications/exampleApp.jar. Quando o JAR for transferido por download, o JWS executará a classe
com.example.MyMainClass. Supondo que tudo que a classe precisa executar está incluído no exampleApp.jar, ela executaria conforme os
usuários a inicializassem. Esse arquivo seria equivalente à execução do comando:
java -cp exampleApp.jar com.example.MyMainClass
|
Nesse exemplo, como o elemento <all-permissions> está presente, exampleApp.jar deve ser assinado.
O elemento <jnlp>, que é o elemento-raiz do arquivo, possui os atributos na Tabela 1.
Tabela 1. Atributos do Elemento <jnlp>
| Atributo | Descrição |
|---|
spec | A versão mínima da especificação do JNLP com a qual este arquivo vai trabalhar | codebase | A URL base do seu aplicativo (as outras URLs no arquivo serão relativas a essa base) | href | A URL do arquivo JNLP em si (arquivos JNLP podem ser utilizados on-line e essa URL diz ao JWS onde obter a versão on-line) | version | A versão do aplicativo e o arquivo JNLP (quando estiver construindo aplicativos JWS, pense neles da mesma forma) |
O elemento <information> possui os atributos mostrados na Tabela 2.
Tabela 2. Atributos do Elemento <information>
| Atributo | Descrição |
|---|
os | O sistema operacional que o aplicativo JWS suporta | arch | A arquitetura (processador) suportada | platform | A plataforma suportada | locale | O código do idioma suportado |
Outros elementos necessários:
- O elemento
<title> contém o título do aplicativo. Ele é exibido no painel de controle do JWS. Ele
também é exibido quando usuários iniciam o aplicativo com JWS.
- O elemento
<vendor> contém o nome do fornecedor de software para o aplicativo.
- O elemento
<resources> contém as informações sobre os recursos que o aplicativo requer. Recursos
aqui incluem os JARs que contêm as classes que seu aplicativo utiliza ou propriedades que seu aplicativo pode configurar e utilizar. Recursos
típicos podem ser listados em qualquer um dos elementos mostrados na Tabela 3 (consulte
Recursos para obter
a listagem completa).
Tabela 3. Elementos <resource> Típicos
| Elemento | Descrição |
|---|
<jar> | Um atributo href que contém o href para um JAR | <nativelib> | Um atributo href que contém o href para o JAR da biblioteca nativa | <j2se> | A versão e os argumentos fornecidos à máquina virtual (VM) | <property> | Especifica as propriedades que podem ser localizadas por System.getProperty |
Para obter a sintaxe completa do arquivo JNLP, consulte os links para a documentação da Sun Microsystems em
Recursos.
| 
