IBM(R) Runtime Environment para Windows(R), Java (TM) 2 Technology Edition, Versão 1.3.1, versão de 32 bits
- LEIA-ME -


Nota: Antes de utilizar estas informações e o produto a que se referem, leia as informações gerais em Avisos.

Esta edição do LEIA-ME aplica-se ao IBM Developer Kit para Windows, Java 2 Technology Edition, Versão 1.3.1, versão de 32 bits, e a todos os releases e modificações subseqüentes, até que seja indicado de outra forma em novas edições.

(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. Todos os direitos reservados.

(c) Copyright International Business Machines Corporation, 1999, 2002. Todos os direitos reservados.

Direitos Restritos para Usuários do Governo dos Estados Unidos - Uso, duplicação e divulgação restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation.


Este arquivo LEIA-ME fornece informações sobre o pacote Runtime Environment fornecido com o IBM(R) Developer Kit para Windows(R), Java(TM) 2 Technology Edition, Versão 1.3.1, versão de 32 bits. Utilize este arquivo LEIA-ME se você pretende distribuir o Runtime Environment com seu produto.

O Runtime Environment é suportado nos seguintes produtos:


Conteúdo

  • Visão Geral
  • Arquivos Incluídos no Runtime Environment
  • Compilador JIT (Just-In-Time)
  • Desativando o JIT
  • Ativando o JIT
  • Determinando se o JIT Está Ativado
  • Obtendo o Número de Versão e Build IBM
  • Chamando o Runtime Environment
  • Requisitos de Redistribuição
  • Java Runtime Interpreter
  • Propriedades do Sistema
  • Exemplo do Runtime
  • Instalando seu Aplicativo em um Sistema de Usuário
  • Especificando a Política de Coleta de Lixo
  • Tempo de Pausa
  • Redução do Tempo de Pausa
  • Ambientes com Heaps Muito Cheios
  • Informações Adicionais sobre Coleta de Lixo
  • Executando Aplicativos Java com Tecnologias Auxiliares Nativas
  • Documentação do Runtime
  • Avisos
  • Marcas

  • Visão Geral

    O Runtime Environment contém a JVM (Java Virtual Machine), as classes Java da Sun Microsystems e os arquivos de suporte. O Runtime Environment não contém todas as classes encontradas no pacote Developer Kit.


    Arquivos Incluídos no Runtime Environment

    O Runtime Environment inclui arquivos .dll e classes para suporte a um programa Java em tempo de execução. O Runtime Environment não inclui nenhuma das ferramentas de desenvolvimento, como appletviewer ou javac, ou classes que possam pertencer apenas a um sistema de desenvolvimento.

    Consulte Requisitos de Redistribuição para obter informações sobre os arquivos que devem ser redistribuídos com programas Java.


    Compilador JIT (Just-In-Time)

    O compilador JIT gera dinamicamente o código de máquina para seqüências de bytecodes utilizadas com freqüência em um aplicativo ou applet Java durante a execução. O compilador JIT (jitc.dll) é ativado por padrão.

    Desativando o JIT

    Você pode desativar o JIT para ajudar no isolamento de um problema com um aplicativo Java, um applet ou com o próprio compilador.

    Há duas formas de desativar o JIT:

    Ativando o JIT

    Para ativar o JIT, digite o seguinte em um prompt de comandos:

        set JAVA_COMPILER=jitc
    

    Determinando se o JIT Está Ativado

    Para verificar se o JIT está ativado ou não, digite o seguinte em um prompt de comandos:

      java -version
    

    Se o compilador JIT estiver sendo usado, uma mensagem será exibida contendo a seguinte mensagem:

        JIT enabled: jitc
    

    Se o compilador JIT não estiver sendo usado, a seguinte mensagem será exibida:

        JIT disabled
    

    Obtendo o Número de Versão e Build IBM

    Digite o seguinte em um prompt de comandos para obter o número de versão e build IBM.

      java -version
    

    Chamando o Runtime Environment

    Para executar um aplicativo Java, digite o seguinte em um prompt de comandos:

        java classname
    

    em que classname é o nome do arquivo da classe Java (aplicativo Java) que você deseja executar. Para obter informações sobre os parâmetros que você pode utilizar ao chamar a ferramenta java, consulte Java Runtime Interpreter.

    Nota: Se o Runtime Environment não tiver sido instalado como a JVM do sistema, será necessário definir, primeiro, o caminho no qual os diretórios apropriados devem ser incluídos. Para atualizar o caminho, digite o seguinte em um prompt de comandos:

        set path=javadir\jre\bin;%path%
    

    em que javadir é o diretório no qual o pacote Runtime Environment está instalado. Por padrão, este diretório é C:\Arquivos de Programas\IBM\Java131.


    Requisitos de Redistribuição

    Quando você redistribui o Runtime Environment, é obrigatória a inclusão dos arquivos do seguinte pacote:

    Para obter informações específicas sobre os arquivos que devem ser redistribuídos, consulte o contrato de licença que acompanha esse produto.

    O termo obrigatória significa que os licenciados que distribuem o runtime devem incluir tais arquivos em seus programas, independentemente se o programa utiliza porventura esses arquivos.

    O Runtime Environment inclui os diretórios \bin e \lib e seus subdiretórios. Esses dois diretórios e seus subdiretórios devem residir no mesmo diretório. O diretório bin contém arquivos executáveis e bibliotecas nativas. O diretório lib contém as classes e os arquivos de propriedade.

    Todos os arquivos nas bibliotecas bin e lib são necessários para redistribuição.

    Nota: A biblioteca de tempo de execução do código nativo C, msvcrt.dll, está localizada no diretório do sistema Windows. Certifique-se que o arquivo esteja no diretório do sistema Windows. A localização deste diretório varia nos diferentes sistemas operacionais, mas é geralmente:


    Java Runtime Interpreter

    A ferramenta java chama o Java Runtime Interpreter para executar aplicativos Java. A sintaxe para iniciar a ferramenta java é a seguinte:

    Uma alternativa para a ferramenta java, javaw, está disponível. A ferramenta javaw é idêntica à ferramenta java, exceto pelo fato de não chamar uma janela do console. A sintaxe para iniciar a ferramenta javaw é a seguinte:

        javaw [options] classname <args>
    

    As opções para a ferramenta java são as seguintes:


    Propriedades do Sistema

    A propriedade do sistema ibm.jvm.bootclasspath pode ser definida utilizando a opção -D descrita na seção Java Runtime Interpreter. O valor desta propriedade é utilizado como um caminho de pesquisa adicional, inserido entre qualquer valor definido por -Xbootclasspath/p: e o caminho de bootclass. O caminho de bootclass é o padrão ou aquele que é definido utilizando a opção -Xbootclasspath:.


    Exemplo de Runtime

    A página da Web da Sun contém um exemplo "Hello World". O exemplo mostra como criar um aplicativo Java simples que é executado e inserido no pacote com o Java Runtime Environment. O site da Web da Sun é http://java.sun.com e você pode encontrar o exemplo "Hello World" pesquisando "Hello World" e "Notes for Developers".

    O exemplo mostra como fazer uma transição simples e sem interrupção do desenvolvimento de um aplicativo com um Developer Kit para a implementação dele com o Runtime Environment.


    Instalando o Aplicativo em um Sistema de Usuário

    Em seu produto, você deve fornecer uma maneira para:

    Se você redistribuir o Runtime Environment, deverá certificar-se que o procedimento de instalação não sobreponha uma instalação existente (a menos que o Java Runtime Environment existente seja uma versão mais antiga).

    A abordagem preferida é extrair os arquivos contidos no arquivo zip redistribuível do Runtime Environment, ibm-jre-n131p-win32-x86.zip, e instalá-los na mesma estrutura de diretórios. Certifique-se de incluir todos os arquivos nos diretórios bin e lib e em seus subdiretórios. Esses diretórios são descritos em Requisitos de Redistribuição. O software Runtime Environment só pode ser redistribuído se todos esses arquivos estiverem incluídos. Na verdade, quando você fornece seu aplicativo, ele tem sua própria cópia do Runtime Environment.

    Se você utilizar essa abordagem, não tente emular as etapas de instalação executadas pelo instalador do Runtime Environment.

    Nota: Quando você instalar o Runtime Environment, deverá gravar as informações do programa no Registro do Windows da seguinte maneira:


    Especificando a Política de Coleta de Lixo

    Este Developer Kit apresenta a opção de tempo de execução -Xgcpolicy da JVM para especificar a política de coleta de lixo.

    -Xgcpolicy obtém dois valores, optthruput (o padrão) e optavgpause. A opção controla o comportamento do coletor de lixo, fazendo trocas para equilibrar o rendimento do aplicativo e do sistema global com os tempos de pausa causados por coleta de lixo.

    O formato da opção e seus valores são:

    -Xgcpolicy:optthruput
    e
    -Xgcpolicy:optavgpause

    Tempo de Pausa

    Quando a tentativa de um aplicativo em criar um objeto não pode ser atendida imediatamente no espaço disponível no heap, o coletor de lixo é responsável pela identificação de objetos não referidos (lixo), por excluí-los e retornar o heap para um estado no qual pedidos de alocação imediatos e subseqüentes possam ser atendidos rapidamente. Tais ciclos de coleta de lixo apresentam pausas ocasionais inesperadas na execução do código de aplicativo. À medida que aumentam o tamanho e a complexidade dos aplicativos, e os heaps tornam-se correspondentemente maiores, este tempo de pausa da coleta de lixo tende a crescer em tamanho e importância. O valor padrão de coleta de lixo, optthruput, possibilita um rendimento mais alto para os aplicativos, porém ao custo dessas pausas ocasionais, que podem variar de alguns milissegundos a muitos segundos, dependendo do tamanho do heap e da quantidade de lixo.

    Redução do Tempo de Pausa

    O valor optavgpause reduz substancialmente o tempo gasto nestas pausas de coleta de lixo, bem como limita o efeito de aumentar o tamanho do heap no comprimento da pausa da coleta de lixo. Isso é relevante especialmente para configurações com grandes heaps. (Considere um heap como grande quando tem pelo menos 1 GB.) Os tempos de pausa são reduzidos sobrepondo-se as atividades de coleta de lixo com a execução normal do programa. Esta sobreposição resulta em uma pequena redução no rendimento do aplicativo.

    Ambientes com Heaps Muito Cheios

    Se o heap Java estiver quase cheio, e houver pouco lixo para ser recuperado, os pedidos de novos objetos poderão não ser atendidos rapidamente por não haver espaço disponível de imediato. Se o heap estiver operando com capacidade quase cheia, o desempenho do aplicativo poderá ser afetado, independentemente de quais opções acima forem utilizadas; e, se pedidos de mais espaço de heap continuarem sendo feitos, o aplicativo receberá uma exceção "Sem Memória", que resulta na finalização da JVM se a exceção não for capturada e manipulada. Nessas situações, é recomendável aumentar o tamanho do heap utilizando a opção -Xmx ou reduzir o número de objetos do aplicativo em uso.

    Informações Adicionais sobre Coleta de Lixo

    Para obter informações sobre o ajuste do tamanho do heap e as implicações da coleta de lixo no desempenho do aplicativo, consulte:


    Executando Aplicativos Java com Tecnologias Auxiliares Nativas

    A Sun fornece o Java Access Bridge para fornecer tecnologias auxiliares nativas do Windows, tais como leitoras de tela, acesso ao suporte de Acessibilidade Java em um aplicativo Java. Essas tecnologias auxiliares nativas do Windows devem ter sido gravadas para fazer chamadas para o Java Access Bridge.

    O Java Access Bridge, disponível na Sun, inclui um instalador que coloca cinco arquivos nos diretórios corretos: access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll e WindowsAccessBridge.dll.

    Se você já tiver instalado o IBM Accessibility Bridge (JawBridge), que permite que o Magnifier do Windows 2000 funcione com aplicativos Swing, e desejar que ele seja executado ao mesmo tempo que o Java Access Bridge, edite a linha no arquivo accessibility.properties para que seja lido o seguinte:

    assistive_technologies=com.sun.java.accessibility.AccessBridge, JawBridge Marque a linha como comentário utilizando um # inicial para desativar ambas as pontes.

    Este site da Web indica como fazer download do Java Access Bridge:


    Documentação do Runtime

    Cada arquivo de propriedade contém comentários que descrevem a utilidade do arquivo e como modificá-lo.


    Avisos

    Estas informações foram desenvolvidas para produtos e serviços oferecidos nos E.U.A.

    A IBM pode não oferecer os produtos, serviços ou recursos mencionados neste documento em outros países. Consulte seu representante da IBM local para obter informações sobre os produtos e serviços atualmente disponíveis em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. No entanto, cabe ao usuário a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM.

    A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviadas, por escrito, para:

    O parágrafo a seguir não se aplica ao Reino Unido ou a qualquer outro país em que tais disposições não estejam de acordo com a legislação local:

    A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE INVIOLABILIDADE, DE MERCADO OU DE ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar ao Cliente.

    Esta publicação pode conter imprecisões técnicas ou erros tipográficos. Periodicamente, são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio.

    Quaisquer referências nestas informações a sites da Web que não sejam da IBM são fornecidas apenas por comodidade e de maneira alguma servem como endosso a esses sites da Web. Os materiais contidos nesses sites da Web não fazem parte dos materiais deste produto IBM e a sua utilização é de sua inteira responsabilidade.

    A IBM poderá utilizar ou divulgar qualquer informação recebida no modo que julgar apropriado, sem incorrer em nenhuma obrigação com o Cliente.

    Os proprietários de licenças deste programa que desejarem obter informações sobre o programa com o propósito de habilitar (i) o intercâmbio de informações entre programas criados de modo independente e outros programas (incluindo este) e (ii) a utilização mútua das informações intercâmbio, devem entrar em contato com:

    Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos, o pagamento de uma taxa.

    O programa licenciado descrito neste documento e todo o material licenciado disponível para o programa são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, Contrato de Licença Internacional de Programa IBM ou qualquer contrato equivalente entre a IBM e o Cliente.

    Todos os dados de desempenho aqui descritos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido tomadas em sistemas em fase de desenvolvimento e não há garantia de que tais medidas sejam as mesmas nos sistemas normalmente disponíveis. Além disso, algumas medidas podem ter sido estimadas através de extrapolação. Os resultados reais podem variar. Os usuários deste documento devem verificar os dados aplicáveis para seus ambientes específicos.

    As informações referentes a produtos não-IBM foram obtidas junto a fornecedores desses produtos, anúncios publicados ou de outras origens publicamente disponíveis. A IBM não testou esses produtos e não pode confirmar a exatidão do desempenho, a compatibilidade ou qualquer outra reclamação relacionada a produtos não-IBM. As questões sobre a capacidade dos produtos não-IBM devem ser encaminhadas aos fornecedores dos respectivos produtos.


    Marcas

    IBM é marca da International Business Machines Corporation nos Estados Unidos e/ou em outros países.

    Java e todas as marcas e logotipos com base em Java são marcas ou marcas registradas da Sun Microsystems, Inc., nos Estados Unidos e/ou em outros países. A tecnologia Java pertence e é exclusivamente licenciada pela Sun Microsystems, Inc.

    Microsoft, Windows, Windows NT e o logotipo do Windows são marcas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

    Outros nomes de empresas, produtos e serviços podem ser marcas ou marcas de serviço de terceiros.