Ajuda do Painel de Controle do Java Plug-in


Os seguintes tópicos são abrangidos nesta ajuda:

Visão Geral

O Painel de Controle do Java Plug-in permite alterar as definições padrão utilizadas pelo Java Plug-in na inicialização. Todos os applets em execução em uma instância ativa do Java Plug-in utilizarão essas definições. O Guia do Desenvolvedor do Java Plug-in, mencionado neste documento, pode ser encontrado em (URL sujeito à alteração). http://java.sun.com/j2se/1.4/docs/guide/plugin/developer_guide/contents.html

Salvando Opções

Quando você tiver concluído suas alterações para as opções do Painel de Controle, clique em Aplicar para salvar as alterações. Clique em Redefinir para cancelar suas alterações e recarregar os últimos valores inseridos e aplicados. Observe que este não é o mesmo que o conjunto de valores padrão que foram definidos originalmente para o Java Plug-in quando ele foi instalado.

Definindo Opções do Painel de Controle

Há seis painéis a partir dos quais você pode definir várias opções no Painel de Controle do Java Plug-in. Esses painéis são rotulados:

Cada um deles é descrito separadamente abaixo.


Básico

Mostrar Console Java

Exibe o Console Java enquanto executa os applets. O console exibe mensagens impressas pelo System.out e System.err. Ele é útil para depurar problemas.

Ocultar Console

O Console Java está em execução, porém ocultado. Esta é a definição padrão (marcada).

Não iniciar console

O Console Java não é iniciado.

Mostrar Caixa de Diálogo de Exceção

Mostra uma caixa de diálogo de exceção quando ocorrerem exceções. O padrão é não mostrar a caixa de diálogo de exceção (desmarcada).


Avançado

Java RunTime Environment

Permite que o Java Plug-in seja executado com qualquer Java 2 JRE ou SDK, Standard Edition v 1.3 ou 1.4 instalado em sua máquina. O Java Plug-in 1.3/1.4 é fornecido com um JRE padrão. No entanto, você pode substituir o JRE padrão e utilizar uma versão mais antiga ou mais recente. O Painel de Controle detecta automaticamente todas as versões do Java 2 SDK ou JRE instaladas na máquina. No quadro de listagem, todas as versões que você pode utilizar são exibidas. O primeiro item na lista sempre será o JRE padrão; o último item sempre indicará Outro. Se você escolher Outro, deverá especificar o caminho para o Java 2 JRE ou SDK, Standard Edition v 1.3/1.4.

Nota

Apenas os usuários avançados devem alterar essa opção. A alteração do JRE padrão não é recomendada.

Parâmetros do Java RunTime

Substitui os parâmetros de inicialização padrão do Java Plug-in especificando opções personalizadas. A sintaxe é a mesma utilizada com parâmetros para a chamada da linha de comandos do java. Consulte a documentação do J2SE (Java 2 Standard Edition) para obter uma lista completa das opções de linha de comandos. A URL abaixo está sujeito a alteração:

http://java.sun.com/j2se/1.4/docs/tooldocs/<platform>/java.html

em que <platform> é um dos sistemas operacionais: solaris, linux, win32.

Seguem abaixo alguns exemplos dos parâmetros do Java Runtime.

Ativando e Desativando o Suporte à Declaração

Para ativar o suporte à declaração, a seguinte propriedade do sistema deve ser especificada nos Parâmetros do Java Runtime:

-D[ enableassertions | ea ][:<package name>"..." | : <class name> ]

Para desativar a declaração no Java Plug-in, especifique o seguinte nos Parâmetros do Java Runtime:

-D[ disableassertions | da ][:<package name>"..." | : <class name> ]

Consulte o Recurso de Declaração para obter detalhes adicionais sobre a ativação/desativação de declarações. http://java.sun.com/j2se/1.4/docs/guide/lang/assert.html (URL sujeito à alteração).

Por padrão, a declaração está desativada no código do Java Plug-in. Como o efeito da decalaração é determinado durante a inicialização do Java Plug-in, a alteração das definições da declaração no Painel de Controle do Java Plug-in requerem que o navegador seja iniciado novamente para que as novas definições sejam efetivadas.

Como o código Java no Java Plug-in também possui declaração interna, é possível ativar a declaração no código do Java Plug-in por meio do seguinte comando:

-D[ enableassertions | ea ]:sun.plugin

Suporte a Rastreio e Registro

O rastreio é um recurso para redirecionar a saída no Console Java para um arquivo de rastreio (.plugin<version>.trace).

-Djavaplugin.trace=true
-Djavaplugin.trace.option=basic|net|security|ext|liveconnect

Se você não desejar utilizar o nome padrão do arquivo de rastreio:

-Djavaplugin.trace.filename=<tracefilename>

De modo semelhante ao rastreio, o registro é um recurso para redirecionar a saída no Console Java para um arquivo de log (.plugin<version>.log) utilizando a API de Registro do Java. É possível ativar o registro por meio da ativação da propriedade javaplugin.logging.

-Djavaplugin.logging=true

Se você não desejar utilizar o nome padrão do arquivo de log, insira:

-Djavaplugin.log.filename=<logfilename>

Além disso, se não desejar sobrescrever os arquivos de rastreio e de log em cada sessão, você poderá definir a propriedade:

-Djavaplugin.outputfiles.overwrite=false.

Se a propriedade for definida como false, os arquivos de rastreio e de log serão nomeados exclusivamente para cada sessão. Se os nomes padrão dos arquivos de rastreio e de log forem utilizados, os arquivos serão nomeados conforme a seguir:

.plugin<username><date hash code>.trace
.plugin<username><date hash code>.log

O rastreio e o registro definidos por meio do Painel de Controle serão efetivados quando o Plug-in for ativado, mas as alterações feitas por meio do Painel de Controle enquanto um Plug-in estiver em execução não terão efeito até um reinício.

Para obter informações adicionais sobre rastreio e registro, consulte Rastreio e Registro no Guia do Desenvolvedor do Java Plug-in.

Depurando Applets no Java Plug-in

As opções a seguir são utilizadas ao depurar applets no Java Plug-in. Para obter informações adicionais sobre este tópico, consulte o Suporte à Depuração no Guia do Desenvolvedor do Java Plug-in.

-Djava.compiler=NONE
-Xnoagent
-Xdebug
-Xrunjdwp:transport=dt_shmem,address=<connect-address>,server=y,suspend=n

O <connect-address> pode ser qualquer cadeia (exemplo: 2502) que é utilizada posteriormente pelo Java Debugger (jdb) para se conectar à JVM.

Tempo Limite de Conexão Padrão

Quando uma conexão é feita por um applet para um servidor, e o servidor não responde apropriadamente, o applet pode parecer travado e também pode causar a interrupção do navegador, porque não há tempo limite de conexão de rede (por padrão, ele é definido para -1, o que significa que não há tempo limite definido).

Para evitar esse problema, o Java Plug-in incluiu um valor padrão de tempo limite de rede (2 minutos) para todas as conexões HTTP. Você pode substituir essa definição nos Parâmetros do Java Runtime:

-Dsun.net.client.defaultConnectTimeout=value in milliseconds

Uma outra propriedade de rede que você pode definir é sun.net.client.defaultReadTimeout.

-Dsun.net.client.defaultReadTimeout=value in milliseconds

Nota

Por padrão, Java Plug-in não define sun.net.client.defaultReadTimeout. Se você desejar defini-lo, faça isso por meio dos Parâmetros do Java Runtime, conforme mostrado acima.

Descrição de Propriedades de Rede:

sun.net.client.defaultConnectTimeout
sun.net.client.defaultReadTimeout

Essas propriedades especificam, respectivamente, os valores padrão do tempo limite de conexão e leitura para as rotinas de tratamento do protocolo utilizadas pelo java.net.URLConnection. O valor padrão definido pelas rotinas de tratamento do protocolo é -1, o que significa que não há tempo limite definido.

sun.net.client.defaultConnectTimeout especifica o tempo limite (em milissegundos) para estabelecer a conexão com o host. Por exemplo, para conexões http, esse é o tempo limite ao estabelecer a conexão para o servidor http. Para conexões ftp, esse é o tempo limite ao estabelecer a conexão para servidores ftp.

sun.net.client.defaultReadTimeout especifica o tempo limite (em milissegundos) ao ler a partir de um fluxo de entrada quando uma conexão é estabelecida para um recurso.

Para a descrição oficial dessas propriedades de rede, consulte http://java.sun.com/j2se/1.4/docs/guide/net/properties.html.


Navegador

Esse painel está relacionado apenas a instalações do Microsoft Windows; ele não aparece em outras instalações. Marque qualquer navegador para o qual você deseja que o Java Plug-in seja o Java Runtime padrão, em vez da JVM interna desse navegador. Isso serve para ativar o suporte à marcação APPLET no Internet Explorer e no Netscape 6 por meio do Java Plug-in.


Proxies

Utilize o painel Proxies para utilizar as definições padrão do navegador ou para substituir o endereço e a porta do proxy para os diferentes protocolos.

Utilizar Definições do Navegador

Marque esta opção para utilizar as definições padrão de proxy do navegador. Esta é a definição padrão (marcada).

Tabela de Informações do Proxy

Você pode substituir as definições padrão desmarcando a caixa de opções "Utilizar Definições do Navegador", em seguida, preenchendo a tabela de informações de proxy sob a caixa de opções. Você pode inserir o endereço e a porta do proxy para cada um dos protocolos suportados: HTTP, Secure (HTTPS), FTP, Gopher e Socks.

Sem Host de Proxy

Este é um host ou lista de hosts para os quais não serão utilizados proxy/proxies. Sem Host de Proxy é geralmente utilizado para um host interno em um ambiente intranet.

URL de Configuração Automática de Proxy

Esta é a URL para o arquivo JavaScript (extensão .js ou .pac) que contém a função FindProxyForURL. FindProxyForURL possui a lógica para determinar o servidor proxy a ser utilizado para um pedido de conexão.

Para obter detalhes adicionais sobre a configuração do proxy, consulte o capítulo Configuração do Proxy no Guia do Desenvolvedor do Java Plug-in.


Cache

Nota

A cache referida aqui é a cache de aderência; isto é, a cache de disco criada e controlada pelo Java Plug-in que o navegador não pode sobrescrever. Consulte Armazenamento do Applet em Cache no Guia do Desenvolvedor do Java Plug-in para obter informações adicionais.

Ativar Armazenamento em Cache

Marque esta opção para ativar o armazenamento em cache. Esta é a definição padrão (marcada). Com o armazenamento do applet em cache, ocorre uma melhora no desempenho porque depois que um applet é armazenado em cache, não é mais necessário que ele seja transferido por download quando referido novamente.

O Java Plug-in armazena em cache os arquivos dos seguintes tipos transferidos por download via HTTP/HTTPS:

.jar (arquivo jar)
.zip (arquivo zip)
.class (arquivo de classe java)
.au (arquivo de áudio)
.wav (arquivo de áudio)
.jpg (arquivo de imagem)
.gif (arquivo de imagem)

Exibir Arquivos em Cache

Pressione esta opção para exibir os arquivos em cache. Um outro diálogo (Visualizador de Cache do Java Plug-in) aparecerá e exibirá os arquivos em cache. O Visualizador da Cache exibe as seguintes informações sobre os arquivos na cache: Nome, Tipo, Tamanho, Data de Expiração, Última Modificação, Versão e URL. No Visualizador da Cache, você também pode excluir seletivamente os arquivos na cache. Esta é uma alternativa para a opção Limpar Cache descrita abaixo, que exclui todos os arquivos na cache.

Limpar Cache

Pressione esta opção para limpar todos os arquivos na cache. Aparecerá o aviso (Apagar todos os arquivos em ... _cache?) antes dos arquivos serem removidos.

Localização

Você pode utilizar esta opção para especificar a localização da cache. A localização padrão da cache é <user home>/.jpi_cache, onde <user home> é o valor da propriedade do sistema user.home. Seu valor depende do S.O.

Tamanho

Você pode marcar Ilimitado para tornar ilimitado o tamanho da cache; ou pode definir o tamanho Máximo da cache. Se o tamanho da cache exceder o limite especificado, os arquivos mais antigos armazenados em cache serão removidos até que o tamanho da cache esteja dentro do limite.

Compactação

Você pode definir a compactação dos arquivos JAR em cache entre Nenhuma e Alta. Embora você economize memória especificando compactação mais alta, o desempenho é degradado; pode-se obter um desempenho melhor sem compactação.


Certificados

Quatro tipos de certificados podem ser selecionados:

Applet Assinado

Estes são os certificados para applets assinados que são confiados pelo usuário. Os certificados que aparecem na lista de applets assinados são lidos a partir do arquivo de certificados jpicerts<version> localizado no diretório <user home>/.java.

Site Seguro

Estes são certificados para sites seguros. Os certificados que aparecem na lista de Site Seguro são lidos a partir do arquivo de certificados jpihttpscerts<version> localizado no diretório <user home>/.java.

CA de Signatário

Estes são os certificados de CAs (Autoridades de Certificação) para applets assinados; eles emitem certificados para os signatários de applets assinados. Os certificados que aparecem na lista de CA de Signatário são lidos a partir do arquivo de certificados cacerts, localizado no diretório <jre>/lib/security.

CA de Site Seguro

Estes são os certificados de CAs (Autoridades de Certificação) para sites seguros; eles emitem os certificados para sites seguros. Os certificados que aparecem na lista de CA de Site Seguro são lidos a partir do arquivo de certificados jssecacerts, localizado no diretório <jre>/lib/security.

Para os certificados Applet Assinado e Site Seguro, existem quatro opções: Importar, Exportar, Remover e Detalhes. O usuário pode importar, exportar, remover e exibir os detalhes de um certificado.

Para CA de Signatário e CA de Site Seguro, existe apenas uma opção: Detalhes. O usuário só pode visualizar os detalhes de um certificado.