Dicas e Truques (JDT)

Editando Reformulando Navegação Procurando Visualizações Diversos Depurando

Editando a Origem

Assistência ao Conteúdo A assistência ao conteúdo fornece uma lista de preenchimentos sugeridos para cadeias parcialmente inseridas. No editor Java, pressione Ctrl+Espaço ou chame Editar > Assistência ao Conteúdo.

Diálogo Seleção de Assistência ao Conteúdo

Assistência ao Conteúdo em Comentários de Javadoc A assistência ao conteúdo também está disponível em comentários de Javadoc.

Comentários de Assistência ao Conteúdo para Javadoc

Suprimir tipos no assistente de conteúdo Para impedir que determinados tipos apareçam no assistente de conteúdo, utilize o recurso de filtro de tipos configurado na página de preferências Abre a página de preferências de filtro de tipos Java > Aparência > Filtros de Tipos. Os tipos que corresponderem a um desses padrões de filtro não aparecerão no diálogo Abrir Tipo e não estarão disponíveis para Assistente de Conteúdo, Correção Rápida e Organizar Importações. Esses padrões de filtro não afetam as visualizações Package Explorer e Hierarquia de Tipo.

Página de preferências de filtro de tipos

Assistência ao Conteúdo para Preenchimentos de Variáveis, Parâmetros de Métodos e Nomes de Campos Você pode utilizar a assistência ao conteúdo para agilizar a criação dos campos, dos parâmetros de método e das variáveis locais. Com o cursor posicionado após o nome do tipo da declaração, chame Editar > Assistência ao Conteúdo ou pressione Ctrl+Espaço.

Sugestões para nomes de campo

Se você utilizar um prefixo ou sufixo de nome para campos, variáveis locais ou parâmetros de método, certifique-se de especificá-lo na página de preferências Abre a página de preferências de estilo de código Java > Estilo de Código.

Dicas de parâmetros Com o cursor em um argumento de método, você pode ver uma lista de dicas de parâmetros. No Editor Java, pressione Ctrl+Shift+Espaço ou chame Editar > Dicas de Parâmetros.

Foco de sugestão de parâmetro

Assistência ao Conteúdo em Classes Anônimas A assistência ao conteúdo também fornece ajuda ao criar uma classe anônima. Com o cursor posicionado após o colchete de abertura de uma criação de instância de classe, chame Editar > Assistência ao Conteúdo ou pressione Ctrl+Espaço.

Assistência ao conteúdo para uma classe anônima

Isso criará o corpo da classe interna anônima, incluindo todos os métodos que precisam ser implementados.
Comutar entre inserção e substituição do assistente de conteúdo Quando o assistente de conteúdo é chamado em um identificador existente, ela pode substituir o identificador pelo preenchimento escolhido ou fazer uma inserção. O comportamento padrão (sobrescrever ou inserir) é definido na página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo.
É possível alternar temporariamente o comportamento enquanto se está dentro do diálogo de seleção do assistente de conteúdo, pressionando e mantendo pressionada a tecla Ctrl enquanto seleciona a conclusão.
Assistência ao Conteúdo Incremental Por padrão, o assistente de conteúdo agora Insere prefixos comuns automaticamente, de maneira semelhante à expansão de shell do Unix. Para alterar o comportamento, desmarque a configuração na página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo.
Customizar o assistente de conteúdo Novo no 3.2 Chamar repetidamente o assistente de conteúdo (Ctrl+Space) repete o ciclo em diferentes categorias de sugestões.

Assistente de conteúdo com novas sugestões do modelo de método

Para configurar quais categorias devem ser mostradas, utilize a página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo > Avançado.

Você também pode designar atalhos do teclado separados para suas categorias de sugestões favoritas.

Criar getters e setters Para criar métodos getter e setter para um campo, selecione a declaração do campo e chame Origem > Gerar Getter e Setter.

Diálogo Gerar Getter e Setter

Se você utilizar um prefixo ou sufixo de nome, certifique-se de especificá-lo na página de preferências Abre a página de preferências de estilo de código Java > Estilo de Código.
Utilizar o assistente de conteúdo para criar getters e setters Outro modo para criar getters e setters é utilizar a assistência ao conteúdo. Posicione o cursor no corpo do tipo entre os membros e pressione Ctrl+Space para obter as propostas para criar um stub de método getter ou setter.
Assistente de conteúdo para criar um setter
Excluir getters e setters juntos com um campo Quando você exclui um campo de uma visualização, o Eclipse pode sugerir a exclusão de seus métodos Getter e Setter. Se você utilizar um prefixo ou sufixo de nome para campos, certifique-se de especificá-lo na página de preferências Abre a página de preferências de estilo de código Java > Estilo de Código.
Criar Métodos de Delegação Para criar um método de delegação para um campo, selecione a declaração do campo e chame Origem > Gerar Métodos de Delegação. Isso adiciona os métodos selecionados ao tipo que contém uma chamada de encaminhamento para os métodos delegados. Esse é um exemplo de um método delegado:
Exemplo de Método de Delegação
Criar hashCode() e equals()
Novo no 3.2
Para criar os métodos hashCode() e equals(), chame Origem > Gerar hashCode() e equals().

Diálogo Gerar hashCode() e equals()

Utilizar Modelos para criar um método Você pode definir um novo modelo que contenha um stub de método utilizando a página de preferências Abre a página de preferências de modelos do editor Java > Editor > Modelos. Os modelos são mostrados juntos com as sugestões da Assistência ao Conteúdo (Ctrl+Espaço).
Também há modelos existentes, como 'private_method', 'public_method', 'protected_method' e outros.
Utilize a tecla Tab para navegar entre os valores a serem inseridos (tipo de retorno, nome e argumentos).

Assistência ao Conteúdo com novas sugestões de modelo de método

Utilizar a Correção Rápida para criar um novo método Inicie com a chamada do método e utilize Correção Rápida (Ctrl+1) para criar o método.

Correção rápida 'Criar Método'

Utilizar a Correção Rápida para Alterar uma Assinatura de Método Inclua um argumento em uma chamada de método em um site de chamada. Em seguida, utilize a Correção Rápida (Ctrl+1) para incluir os parâmetros exigidos na declaração de método.

Correção rápida 'Alterar Assinatura'

Utilizar a Assistência ao Conteúdo para Criar um Stub de Construtor No local no qual você deseja incluir o novo construtor, utilize o assistente de conteúdo depois de digitar as primeiras letras do nome do construtor.
Criar construtor com assistente de conteúdo
Criar Novos Campos a partir de Parâmetros É necessário criar novos campos para armazenar os argumentos transmitidos no construtor? Utilize a Assistência Rápida (Ctrl+1) em um parâmetro para criar a designação e a declaração de campo e permitir que o Eclipse sugira um nome de acordo com as preferências do Estilo de Código.
Assistência rápida 'Designar parâmetro para novo campo'
Utilizar a Assistência ao Conteúdo para substituir um método Chame a Assistência ao Conteúdo (Ctrl+Espaço) no corpo do tipo na localização em que o método deve ser adicionado. A assistência ao conteúdo oferecerá todos os métodos que podem ser substituídos. Um corpo de método será criado para o método escolhido.

Assistência ao conteúdo 'Substituir Método'

Utilizar a Correção Rápida para Incluir Métodos não Implementados Para implementar uma nova interface, adicione a declaração 'implements' primeiramente ao tipo. Mesmo sem gravar ou construir, o editor Java sublinhará o tipo para sinalizar que há métodos ausentes e mostrará a lâmpada elétrica de Correção Rápida. Clique na lâmpada elétrica ou pressione Ctrl+1 (Editar > Correção Rápida) para escolher entre incluir os métodos não implementados ou tornar sua classe abstrata.

Correção Rápida oferecendo a sugestão 'Incluir Métodos não Implementados'

Substituir um Método de uma Classe base Para criar um método que substitui um método de uma categoria básica:
Selecione o tipo no qual os métodos devem ser incluídos e chame Origem > Substituir/Implementar Métodos. Isso abre um diálogo que permite escolher quais métodos devem ser substituídos.

Diálogo 'Substituir/Implementar Método'

Criar um tipo a partir de um trecho de exemplo
Novo no 3.2
Você pode colar um trecho de código contendo um tipo Java diretamente em um pacote ou pasta de origem para criar uma nova unidade de compilação. Por exemplo, selecione e copie este código-fonte
package pack;
   public class HelloWorld {
public static void main(String[] args) {
        System.out.println("Hello World");
    }
}
em seguida, selecione uma pasta de origem no Explorador de Pacotes e utilize Ctrl+V (Editar > Colar). Isso cria automaticamente um novo pacote 'pack' e um arquivo 'HelloWorld.java' com o conteúdo copiado.
Renomear no arquivoPara fazer rapidamente uma renomeação que não requer análise completa de dependências em outros arquivos, utilize a Assistência Rápida 'Renomear no Arquivo'. No Editor Java, posicione o cursor em um identificador de uma variável, método ou tipo e pressione Ctrl+1 (Editar > Correção Rápida)
O editor é alternado para o modo de edição vinculada (como modelos) e a alteração do identificador altera simultaneamente todas as outras referências a essa variável, método ou tipo.

Alterando vários identificadores utilizando a correção rápida 'Renomeação Local'

Você também pode utilizar o atalho direto Ctrl+2 R. Utilize a página de preferências Abre a página de preferências de chaves Geral > Chaves para configurar atalhos (na categoria 'Origem').
Utilizar a Correção Rápida para tratar de exceções Lidar com exceções lançadas é fácil. As exceções não tratadas são detectadas durante a digitação e marcadas com uma linha vermelha no editor.
  • Clique na lâmpada elétrica ou pressione Ctrl+1 para demarcar a chamada com um bloco try catch. Se você desejar incluir instruções adicionais no bloco try, selecione as instruções e utilize Origem > Demarcar com > Bloco Try/Catch. Também é possível selecionar instruções individuais utilizando Editar > Expandir Seleção para e selecionando Anexar, Avançar ou Anterior.
  • Se a chamada já estiver demarcada com um bloco try, a Correção Rápida sugerirá a adição do bloco catch ao bloco existente.
  • Se você não desejar tratar da exceção, deixe que a Correção Rápida adicione uma nova exceção emitida à declaração anexada do método

Sugestões de correção rápida 'Exceção não Capturada'

A qualquer momento, você pode converter um bloco catch em uma exceção emitida. Utilize Ctrl+1 (Editar > Correção Rápida) em um bloco catch.

Assistência rápida 'Substituir cláusula catch por throws'

Menos digitação para atribuições Em vez de digitar uma designação, inicie com a expressão que será atribuída.

Assistência rápida 'Designar instrução para variável local'

Agora utilize Ctrl+1 (Editar > Correção Rápida) e escolha 'Atribuir Instrução à Nova Variável Local' e a Assistência Rápida sugerirá um nome de variável para você.
Designação de Assistência Rápida
Menos Trabalho com Expressões Cast Não gastar muito tempo ao digitar conversões. Ignorá-los primeiro e utilizar a assistência rápida para incluí-los após a finalização da instrução.

Para obter exemplos de designação:
Incluir conversão na designação
Ou para argumentos de método:
Incluir conversão para argumentos de método
Ou para destinos de chamada de método:
Incluir conversão nos destinos de chamada de método

Designar uma Expressão com Coerção
Após uma verificação de 'instanceof', é muito comum moldar a expressão e designá-la a uma nova variável local. Chame a Assistência Rápida (Ctrl+1) na palavra-chave 'instanceof' para economizar algum tempo, digitando:
'Apresentar Novo Local com Correção Rápida de Tipo Moldado
Mais Correções Rápidas
Verifique a página Assistência Rápida para obter uma lista completa de transformações de código disponíveis. Entre elas estão
  • Inverter instruções if
  • Converter 'switch' em 'if-else'
  • Substituir 'if-else' por condicional
    ...e muitas mais
Uma lista de correções rápidas pode ser encontrada aqui.
Atalhos para Correções e Assistências Rápidas
Algumas das assistências rápidas mais populares como Renomear em Arquivo e Designar para Local podem ser chamadas diretamente com Ctrl+2 R e Ctrl+2 L. Verifique a página de preferências Abre a página de preferências de chaves Geral > Chaves para obter correções rápidas adicionais que suportam chamada direta.

Página de preferências de teclas com atalhos para assistência rápida

Demarcar linhas Para demarcar instruções com uma instrução if / while / for ou um bloco, selecione as linhas a serem demarcadas e chame Origem > Demarcar com ou pressione Alt+Shift+Z.

Assistência rápida 'Demarcar com modelos'

As entradas no menu são derivadas dos modelos do editor normal: todos os modelos que contiverem a variável ${line_selection} serão mostrados no menu.

Os modelos podem ser configurados na página de preferências Abre a página de preferências de modelos do editor Java > Editor > Modelos. Edite os modelos correspondentes para customizar o código resultante ou defina seus próprios modelos demarcados.
Criar seus próprios modelos Para criar seus próprios modelos, vá para a página de preferências Abre a página de preferências de modelos do editor Java > Editor > Modelos e pressione o botão Novo para criar um modelo. Por exemplo, um modelo a ser iterado em ordem inversa em uma matriz seria semelhante a este:

Modelo para um iterador

O assistente de conteúdo pode inserir nomes de argumentos automaticamente Você pode permitir que o assistente de conteúdo insira nomes de argumentos automaticamente na conclusão de um método. Esse comportamento pode ser customizado na página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo (consulte a caixa de opções Preencher nomes de argumentos na conclusão.) Por exemplo, ao selecionar a segunda entrada aqui,

janela do assistente de conteúdo

O assistente de conteúdo inserirá automaticamente nomes de argumentos:

Nomes de argumentos inseridos pelo assistente de conteúdo

Você poderá, então, utilizar a tecla Tab para navegar entre os nomes inseridos.

O assistente de conteúdo também pode descobrir nomes de argumentos - com base em seus tipos declarados. Isso pode ser configurado pela caixa de opções Descobrir nomes de argumentos preenchidos na página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo.

Inserir Argumentos de Tipo Automaticamente
A ativação de Preencher nomes de argumentos na conclusão na página de preferências Abre a página de preferências do assistente de conteúdo Java > Editor > Assistente de Conteúdo também é útil ao trabalhar com tipos parametrizados no J2SE 5.0.
Assistente de conteúdo em um tipo parametrizado
resulta em:
Argumento de tipo descoberto e inserido pelo assistente de conteúdo
Remover instrução de demarcação Para remover uma instrução ou bloco de demarcação, posicione o cursor no colchete de abertura ou fechamento e pressione Ctrl+1 (Editar > Correção Rápida).

Assistência rápida 'Remover instrução de demarcação'

Como a Palavra Foi Soletrada Novamente? Você pode ativar o suporte à verificação ortográfica no editor Java na página de preferências Abre a página de preferências de ortografia Geral > Editores > Editores de Texto > Ortografia. Os erros de ortografia são exibidos no editor Java, e as Correções Rápidas correspondentes estão disponíveis:

Um Exemplo de uma Proposta de Correção de Ortografia.

Você também pode disponibilizar o dicionário na assistência ao conteúdo. Contudo, não há nenhum dicionário atualmente incluído no Eclipse. O formato requerido é apenas uma lista de palavras separadas por novas linhas e as Correções Rápidas permitem incluir novas palavras no dicionário dinamicamente. Contribuições para os dicionários serão bem-vindas.

Seleções estruturadas Você pode selecionar rapidamente o código Java utilizando de modo sintático o recurso Seleção Estruturada.
Realce o texto e pressione Alt+Shift+Seta para Cima ou selecione Editar > Expandir Seleção para > Elemento Anexo na barra de menus - a seleção será expandida para o menor elemento de sintaxe Java que contiver a seleção. Você pode expandir ainda mais a seleção chamando novamente a ação.
Localizar o colchete correspondente Para localizar um colchete correspondente, selecione um colchete de abertura ou fechamento e pressione Ctrl+Shift+P ou selecione Navegar > Ir para > Colchete Correspondente. Também é possível clicar duas vezes antes do colchete de abertura ou após um colchete de fechamento - isso seleciona o texto entre os dois colchetes.

Utilizando 'clique duplo' para selecionar o texto entre os colchetes

Javadoc inteligente Digite '/**' e pressione Enter. Isso adiciona automaticamente um stub de comentário de Javadoc contendo as marcações padrão @param, @return e @exception.

Resultado de 'Javadoc Inteligente'

Os modelos para o novo comentário podem ser configurados na página de preferências Abre a página de preferências de modelos do código Java > Estilo de Código > Modelos de Código.
Mostrar Somente Origem do Elemento Selecionado Pressione o botão da barra de ferramentas Mostrar Somente Origem de Elemento Selecionado Mostrar Somente Origem de Elemento Selecionado para exibir uma visualização segmentada da unidade de compilação. Quando ativado, o editor Java exibirá somente o elemento (por exemplo, um método) selecionado nas visualizações Esboço ou Hierarquia. Quando desativado, o editor Java exibirá a unidade de compilação inteira.
Utilizar o histórico local para reverter para uma edição anterior de um método Sempre que você edita um arquivo, seu conteúdo anterior é mantido no histórico local. A ferramenta Java torna o histórico local disponível para os elementos Java, assim você pode reverter para uma edição anterior de um único método em vez do arquivo completo.

Selecione um elemento (por exemplo, na visualização Esboço) e utilize Substituir por > Histórico Local para reverter para uma edição anterior do elemento.

Diálogo Substituir do Histórico Local

Utilizar o Histórico Local para Restaurar Métodos Removidos Sempre que você edita um arquivo, seu conteúdo anterior é mantido no histórico local. A ferramenta Java torna o histórico local disponível para os elementos Java, assim você pode restaurar seletivamente os métodos excluídos.

Selecione um contêiner (por exemplo, na visualização Esboço) e utilize Restaurar do Histórico Local para restaurar quaisquer membros removidos.

Diálogo Restaurar do Histórico Local

Geração de código personalizável A página de preferências Abre a página de preferências de modelos do código Java > Estilo de Código > Modelos do Código permite customizar código e comentários gerados de um modo semelhante aos modelos normais. Esses modelos de código são utilizados sempre que um código é gerado.

Página de preferências de modelos do código

A partir do 3.1, é possível utilizar modelos do código específico do projeto, que também serão compartilhados pela equipe se seu projeto for compartilhado. Abra as Propriedades no projeto para ativar configurações específicas do projeto.
Criar Comentários no Código Os comentários podem ser incluídos explicitamente com Origem > Gerar Comentário de Elemento (Alt+Shift+J) ou automaticamente por vários assistentes, reformulações ou correções rápidas.
Configure os modelos de comentário na página de preferências Abre a página de preferências de modelos do código Java > Estilo de Código > Modelos do Código.
Ative ou desative a geração automática de comentários diretamente no assistente (por exemplo, utilizando a caixa de opções 'Gerar Comentário' nos assistentes de Novo Tipo Java) ou pela caixa de opções 'Incluir automaticamente novos comentários para novos métodos e tipos' da página de preferências Abre a página de preferências de estilo de código Java > Estilo de Código.
Todas essas configurações também podem ser configuradas em uma base por projeto. Abra as Propriedades no projeto para ativar configurações específicas do projeto.
Classificar Membros Você pode Classificar Membros de uma unidade de compilação Java de acordo com uma ordem de categoria definida na página de preferências Abre a página de preferências de ordem de classificação de membros Java > Aparência > Ordem de Classificação de Membros.
Você localizará a ação em Origem > Classificar Membros.
Quebrar cadeias Você pode quebrar os literais de Cadeia quando os editar. Por exemplo, se houver um código como este:
String message= "Esta é uma mensagem longa.";

posicione o sinal de intercalação após a palavra "uma" e pressione Enter. O código será automaticamente alterado para:

String message= "Esta é uma" +
           " mensagem longa.";

Esse comportamento pode ser customizado na página de preferências Abre a página de preferências de digitação Java > Editor > Digitação.

Digitação Inteligente e como Controlá-la Os recursos de Digitação Inteligente do editor Java facilitam seu trabalho diário. Você pode configurá-los na página de preferências Abre a página de preferências de digitação Java > Editor > Digitação.

Página de preferências de digitação do editor Java

Quando você ativa Inserir Pontos-e-vírgulas na Posição Correta, a digitação de um ponto-e-vírgula posiciona automaticamente o cursor no final da instrução antes da inserção do ponto-e-vírgula. Isso economiza navegação adicional do cursor.
Você pode desfazer esse posicionamento automático pressionando backspace à direita, posteriormente.

Corrigir o recuo do código com um pressionamento de tecla Um recurso útil é Origem > Corrigir Recuo ou Ctrl+I.
Selecione o código no qual os recursos estão incorretos e chame a ação.

Se nada for selecionado, a ação recuará a linha atual.

Menus Rápidos para Ações de Origem e de Reformulação As ações de reformulação e de origem podem ser acessadas por meio de um menu rápido. Selecione o elemento a ser manipulado no editor Java ou em uma visualização Java e pressione Alt+Shift+S para o menu de origem rápida, Alt+Shift+T para o menu de reformulação rápida e Alt+Shift+Z para o menu de demarcação.

Menu Reformulação Rápida

Localizar código não utilizado O compilador Java detecta códigos não alcançáveis, variáveis não utilizadas, parâmetros, importações e tipos, métodos e campos específicos não utilizados. A configuração está na página de preferências Abre a página de preferências de erro/aviso Java > Compilador > Erro/Avisos (ou configurada para um projeto individual utilizando Projeto > Propriedades > Compilador Java > Erro/Avisos).

Página de Preferências do Compilador

Essas configurações também são detectadas durante a digitação e uma correção rápida é oferecida para remover o código desnecessário.
Manipulação de comentários de Javadoc O compilador do Eclipse Java pode processar comentários de Javadoc. Procure referências de relatório nos comentários de doc, e a reformulação também atualiza essas referências. Esse recurso é controlado na página de preferências Abre a página de preferências de problemas Javadoc Java > Compilador > Javadoc (ou configurado para um projeto individual utilizando Projeto > Propriedades > Compilador Java > Javadoc).

Página de Preferências de Javadoc

Quando ativados, os comentários de Javadoc defeituosos são marcados no editor Java e podem ser corrigidos utilizando Editar > Correção Rápida (Ctrl+1):

Problemas detectados no Javadoc

Suprimir Avisos No J2SE 5.0 e posterior, você pode suprimir todos os avisos opcionais do compilador utilizando a anotação SuppressWarnings.
Neste exemplo, addAll() é marcado como um método não utilizado. A Correção Rápida (Ctrl+1) é utilizada para incluir uma anotação SuppressWarnings para que o aviso não seja mostrado para esse método.
Correção Rápida para Incluir Anotação SuppressWarning
Assistente de Limpeza
Novo no 3.2
O Assistente de Limpeza ajuda a corrigir vários problemas imediatamente e ajuda a estabelecer um estilo de código.
Por exemplo, você pode:
  • converter todos os loops for para loops for aperfeiçoados, onde possível.
  • marcar todos os métodos de substituição em um projeto inteiro com uma anotação @Override.
O assistente também é útil ao converter código compatível com Java 1.4 para Java 5.0.

Figura do Assistente de Limpeza

Selecione um projeto, pacote ou arquivo e utilize Origem > Limpar... para iniciar esse assistente.

Reformulação

Script de Reformulações
Novo no 3.2
Além de serem executadas interativamente, a maioria das reformulações oferecidas pelo JDT também podem ser executadas por um script de reformulação.

Crie um script de reformulação a partir do histórico de reformulações utilizando Reformular > Criar Script....

Um script de reformulação pode ser, então, aplicado posteriormente a um espaço de trabalho arbitrário utilizando Reformular > Aplicar Script....

Tais scripts de reformulação podem ser utilizados em diferentes cenários, como na correção automática de interrupção de alterações da API entre camadas de software ou do fornecimento de correções com sofisticada semântica.
Migração Segura do Arquivo JAR
Novo no 3.2
Ao exportar um arquivo JAR do espaço de trabalho, o Assistente de Exportação de JAR oferece a opção para incluir informações de reformulação no arquivo JAR.

Utilize Arquivo > Exportar... e selecione Arquivo JAR. Na primeira página do Assistente de Exportação de JAR, selecione Exportar reformulações para projetos marcados. Clique no link para selecionar as reformulações a serem incluídas.

Os clientes podem, então, migrar uma versão antiga do arquivo JAR para uma nova utilizando a reformulação Reformular > Migrar Arquivo JAR.... Essa reformulação atualizará automaticamente todo o código dependente da versão antiga do arquivo JAR para utilizar a nova versão do arquivo JAR.

Procurando

Localizar variáveis e seus acessos de leitura/gravação Você pode localizar variáveis e ver seus status de leitura/gravação selecionando um identificador (referência ou declaração de variável, método ou tipo) e chamando Procurar > Ocorrências no Arquivo. Isso marca todas as referências desse identificador no mesmo arquivo. Os resultados também são mostrados na visualização de procura, juntamente com os ícones que mostram o acesso de leitura ou gravação da variável.

Acessos de leitura e gravação a um campo

Alternativamente, utilize o recurso Marcar Ocorrências para realçar ocorrências dinamicamente. Você pode procurar vários arquivos utilizando os recursos gerais de procura (Procurar > Referências).

Procurar métodos com um tipo específico de retorno Para procurar métodos com um tipo de retorno específico, utilize "* <tipo de retorno>" conforme a seguir:
  • Abra o diálogo de procura e clique na guia Procura Java.
  • Digite '*' e o tipo de retorno, separados por um espaço, na Cadeia de Procura.
  • Selecione a caixa de opções Distinção entre Maiúsculas e Minúsculas.
  • Selecione Método e Declarações e, em seguida, clique em Procurar.

Procurar método com o tipo de retorno fornecido

Filtrar correspondências de procura em Javadoc Por padrão, a Procura Java localiza referências em código Java e em Javadoc. Se você não desejar ver as referências em Javadoc, poderá filtrar essas correspondências ativando 'Filtrar Javadoc' no menu de visualização (símbolo de triângulo) da visualização de procura.
Filtrar potenciais correspondências de procura As potenciais correspondências ocorrem quando um problema no tempo de compilação impede que o mecanismo de procura resolve completamente a correspondência. Filtre essas correspondências com Filtrar Potencial no menu de visualização de procura (símbolo de triângulo).
Cadeias de Chamada de Método de Rastreio com a Hierarquia de Chamada Utilize a Hierarquia de Chamada para seguir cadeias de chamadas longas ou complexas sem perder o contexto original: simplesmente selecione um método e chame Navegar > Abrir Hierarquia de Chamada (Ctrl+Alt+H).

Visualização Hierarquia de Chamada

Navegação e Leitura de Código

Abrir uma seleção no editor Java Existem duas maneiras de abrir um elemento a partir de uma referência no editor Java.
  • Selecione a referência no código e pressione F3 (Navegar > Abrir Declaração)
  • Pressione Ctrl, mova o ponteiro do mouse sobre a referência e clique no hyperlink
Navegação no estilo hyperlink
A navegação no estilo de hyperlink pode ser configurada com a caixa de opções Suportar navegação no estilo de hyperlink na página de preferências Abre a página de preferências de editores de texto Geral > Editores > Editores de Texto.
Outlines no local Pressione Ctrl+F3 no editor Java para exibir um outline no local do elemento na posição atual do cursor. Ou pressione Ctrl+O (Navegar > Contorno Rápido) para exibir um contorno no local do arquivo de origem atual.

Contorno no local

Contornos no Local Mostram Membros Herdados Pressione Ctrl+O ou Ctrl+F3 novamente para incluir membros herdados em um contorno Local aberto. Os membros herdados têm uma etiqueta cinza. Filtre e classifique o contorno com o menu no campo superior direito.

Visualização Rápida de Tópicos

Hierarquia Local Descubra quais são os possíveis receptores de uma chamada virtual utilizando a Hierarquia de Tipo Rápido. Posicione o cursor na chamada de método e pressione Ctrl+T (Navegar > Hierarquia de Tipo Rápido). A visualização mostra todos os tipos que implementam o método com um ícone completo.

Visualização Hierarquia Rápida

Pressione Enter para abrir o método correspondente em um editor. Pressione Ctrl+T novamente para comutar para a hierarquia Supertipo.

Realce Avançado O editor Java pode realçar o código fonte de acordo com sua semântica (por exemplo: campos estáticos, variáveis locais, chamadas de método estático). Examine as diversas opções na página de preferências Abre a página de preferências de coloração da sintaxe Java > Editor > Coloração da Sintaxe.

Um exemplo de realce avançado.

Regiões Inicialmente Compactadas Você pode especificar quais regiões são incluídas por padrão quando um editor está aberto. Examine a página de preferências Abre a página de preferências de compactação Java > Editor > Compactação para customizar isso.

Página de Preferências de Compactação

Marcar Ocorrências Ao trabalhar no editor, ative Marcar Ocorrências na barra de ferramentas (Imagem do Botão Marcar Ocorrências da Barra de Ferramentas ) ou pressione Alt+Shift+O. Você verá dentro de um arquivo onde uma variável, método ou tipo é referido.
Editor com ocorrências de 'info' marcadas
A seleção de um tipo de retorno mostra os pontos de saída do método. Selecione uma exceção para ver onde ela será lançada.
Editor com as saídas de método marcadas
Selecione uma superclasse ou interface para ver a substituição dos métodos ou implementar um método no tipo super selecionado.
Ajuste 'marcar ocorrências' na página de preferências Abre a página de preferências Marcar Ocorrências Java > Editor > Marcar Ocorrências.
Altere a cor para o marcador na página de preferências Abre a página de anotações Geral > Editores > Editores de Texto > Anotações.
Ir para método anterior / seguinte Para navegar rapidamente para o método ou o campo seguinte ou anterior, utilize
Ctrl+Shift+Seta para Cima (Navegar > Ir para > Membro Anterior) ou Ctrl+Shift+Seta para Baixo (Navegar > Ir para > Próximo Membro)
Controlar sua Navegação entre Anotações Utilize os botões Próxima / Anotação Anterior da barra de ferramentas ou Navegar > Próxima Anotação (Ctrl+.) e Navegar > Anotação Anterior (Ctrl+,) para navegar entre anotações em um arquivo de origem Java. Com os menus drop-down do botão, você pode configurar em quais anotações deseja parar:

Drop-down Anotação Seguinte/Anterior.

Lembretes no Código Java Quando você efetua a marcação de um comentário no código fonte Java com "TODO", o compilador Java cria automaticamente uma tarefa correspondente como um lembrete. Abrindo a tarefa, você navega de volta para "TODO" no código. Utilize a página de preferências Abre a página de tarefas Java > Compilador > Tags de Tarefa para configurar quaisquer outras tags especiais (como "FIXME") que você gostaria de acompanhar na lista de tarefas.

Marcações de tarefa no editor e visualização de tarefas

Sugestões no Diálogo Tipo Baseado em Padrões Abertos
O diálogo Abrir Tipo (Navegar > Abrir Tipo ou o botão da barra de ferramentas) ajuda a navegar para um tipo por seu nome.
  • Para localizar tipos rapidamente, digite apenas as letras maiúsculas do nome do tipo: IOOBE localiza IndexOutOfBoundsException
  • Para ver todos os tipos que terminam com um determinado sufixo, por exemplo, all Tests, utilize *Test< para não ver todos os tipos que contêm Test em algum outro lugar no nome do tipo.
Diálogo de Tipo Baseado em Padrões Abertos com Correspondência de Camel Case
Tornar os focos aderentes Você pode abrir o texto a partir de um foco em uma janela rolável, pressionando F2 (Editar > Mostrar Descrição da Ferramenta). Você pode selecionar e copiar o conteúdo a partir dessa janela.

Janela com o conteúdo do foco

Focos no editor Java Você pode ver diferentes focos no editor Java utilizando as teclas de modificador (Shift, Ctrl, Alt).
Quando você move o mouse sobre um identificador no editor Java, por padrão, é mostrado um foco com o Javadoc extraído da origem correspondente deste elemento. Manter pressionada a tecla Ctrl mostra o código fonte.

Foco mostrando o código do elemento no foco

Você pode alterar esse comportamento e definir os focos para outras teclas modificadoras na página de preferências Abre a página Focos Java > Editor > Focos.
Assinatura Inferida de Método Genérico
Você pode utilizar o foco para mostrar a assinatura inferida de um método genérico.

Foco Mostrando Assinatura Inferida de Método Genérico

Abrir e configurar a documentação do Javadoc externo Se você desejar abrir a documentação do Javadoc para um tipo, método ou campo com Shift+F2 (Navegar > Abrir Javadoc Externo), você primeiro deve especificar os locais da documentação para a biblioteca pai de elementos (JAR, pasta de classe) ou projeto (pasta de origem).
Para bibliotecas, abra a página do caminho de construção (Projeto > Propriedades > Caminho de Construção Java), vá para Bibliotecas e expanda o nó da biblioteca na qual é possível editar o nó 'Local do Javadoc'. A documentação pode ser local em seu sistema de arquivos em uma pasta ou archive ou em um servidor da Web.

Configurando local do Javadoc no diálogo Caminho de Construção Java

Para tipos, métodos ou campos em pastas de origem, vá para (Projeto > Propriedades > Localização do Javadoc).

Visualizações Java

Organizando o espaço de trabalho com vários projetos Utilize Elementos de Nível Superior > Conjuntos de Trabalho no menu de visualização do Explorador de Pacotes para ativar um novo modo que mostre os conjuntos de trabalho como elementos de nível superior. Esse modo facilita muito o gerenciamento de espaços de trabalho que contêm muitos projetos.

Explorador de Pacotes no modo de Conjunto de Tarefas

Utilize Configurar Conjuntos de Trabalho no menu da visualização do Explorador de Pacotes para configurar quais conjuntos de trabalho são mostrados. O diálogo permite que você crie novos conjuntos de tarefas Java, defina quais conjuntos de tarefas são mostrados e em qual ordem. Conjuntos de tarefas também podem ser reorganizados diretamente no Explorador de Pacotes utilizando as funções arrastar e soltar e copiar/colar.

Visualização Declaração A visualização Declaração ( Abre a visualização Declaração Java Janela > Mostrar Visualização > Outro... > Java > Declaração) mostra a origem do elemento selecionado no editor Java ou em uma visualização Java.

Visualização Declaração

Visualização Javadoc Existe uma visualização Javadoc ( Abre a visualização Javadoc Janela > Mostrar Visualização > Outro... > Java > Javadoc) que mostra o Javadoc do elemento selecionado no editor Java ou em uma visualização Java. A visualização Javadoc utiliza o widget SWT Browser para exibir HTML em plataformas que o suportam.

Visualização Javadoc

Implementações / definições de método e visualização de hierarquia de tipo Para descobrir quais tipos em uma hierarquia substituem um método, utilize o recurso 'Mostrar Membros na Hierarquia'.
  • Selecione o método que deseja ver e pressione F4 (Navegar > Abrir Hierarquia de Tipo). Isso abre a visualização de hierarquia de tipo no tipo de declaração do método.
  • Com o método selecionado na visualização Hierarquia, pressione o botão da barra de ferramentas 'Travar Visualização e Mostrar Membros na Hierarquia'.
  • A visualização de hierarquia agora mostra apenas os tipos que implementam ou definem o método 'travado'. Você pode, por exemplo, ver se isEmpty() está definido em List e implementado em ArrayList e Vector mas não em AbstractList.

Travar visualização e mostrar membros na Hierarquia

A visualização Hierarquia de Tipo suporta o agrupamento por tipo definidor A visualização do método da hierarquia de tipo permite classificar os métodos do tipo selecionado por seus tipos definidores. Por exemplo, para AbstractList, você pode ver se ele contém métodos que foram definidos em Objeto, Coleta e Lista:

Classificar membros pelo tipo de definição na hierarquia de tipo

Sugestões para a Hierarquia de Tipo
  • Focalize a hierarquia de tipo em um novo tipo pressionando F4 (Navegar > Abrir Hierarquia de Tipo) em um elemento ou nome selecionado.
  • Você pode abrir a visualização Hierarquia não apenas em tipos, mas também em pacotes, pastas de origem, archives JAR e projetos Java.
  • Você pode Arrastar & Soltar um elemento na visualização Hierarquia para focalizá-lo nesse elemento.
  • Você pode alterar a orientação (de vertical padrão para horizontal) da visualização Hierarquia no menu da barra de ferramentas da visualização.
Comparação estrutural de origem Java Uma comparação estrutural de origem Java ignora a ordem textual de elementos Java, como métodos e campos, e mostra, de uma forma mais clara, quais elementos foram alterados, incluídos ou removidos.
Para iniciar uma comparação estrutural de arquivos Java, você tem duas opções:
  • Selecionar duas unidades de compilação Java e escolher Comparar com > Um com o Outro no menu de contexto da visualização. Se os arquivos tiverem diferenças, eles serão abertos em um Editor de Comparação. A área de janela superior mostra os elementos Java divergentes; o clique duplo em um deles mostra a origem do elemento na área de janela inferior.
  • Em qualquer contexto em que uma comparação de arquivos esteja envolvida (por exemplo, uma Sincronização de CVS), um clique duplo em um arquivo Java não apenas mostra o conteúdo do arquivo em um visualizador de comparação de texto, mas também executa uma comparação estrutural e abre uma nova área de janela mostrando os resultados.

Comparação estrutural de origem Java

Você pode ainda ignorar comentários e alterações de formatação ao executar a comparação estrutural: ative a opção Ignorar Espaços em Branco por meio do botão Editor de Comparação da barra de ferramentas ou do menu drop-down Visualização Sincronização de CVS.
Comparação Estrutural dos Arquivos de Propriedade Uma comparação estrutural dos arquivos de propriedade Java (extensão: .properties) ignora a ordem textual das propriedades e mostra quais propriedades foram alteradas, incluídas ou removidas.
Para iniciar uma comparação estrutural dos arquivos de propriedade, você tem duas opções:
  • Selecionar dois arquivos no Package Explorer ou Navigator e escolher Comparar com > Um com o Outro no menu de contexto da visualização.
  • Em qualquer contexto em que uma comparação de arquivos esteja envolvida (por exemplo, uma Sincronização de CVS), um clique duplo em um arquivo de propriedades não apenas mostra o conteúdo do arquivo em um visualizador de comparação de texto, mas também executa uma comparação estrutural e abre uma nova área de janela mostrando os resultados.

Comparação estrutural dos arquivos de propriedade

Apresentação hierárquica vs. simples de pacotes Uma opção no menu de visualização Pacotes Java (e Explorador de Pacotes) permite alterar o modo de exibição dos pacotes. Apresentação de Pacotes > Hierárquica exibe pacotes em uma árvore, com subpacotes abaixo de pacotes; Apresentação de Pacotes > Simples exibe-os na disposição padrão, como uma lista simples com todos os pacotes e subpacotes como irmãos.
Layout plano de pacotes Layout hierárquico de pacotes
Pacotes lógicos A visualização Pacotes Java (perspectiva Procura Java) une pacotes do mesmo nome ao longo das pastas de origem dentro de um projeto. A captura de tela mostra a visualização Pacotes contendo um pacote lógico.

Perspectiva de navegação Java contendo um pacote lógico

Compactar Nomes de Pacotes Se seus nomes de pacotes forem muito longos, você poderá configurar um nome compactado que aparece nos visualizadores. A configuração do padrão de compactação é feita na página de preferências Abre a página de preferências Aparência Java > Aparência.

Configuração do Padrão de Compactação na Página de Preferências de Aparência de Java

Utilizando este exemplo, os pacotes são apresentados da seguinte forma:

Nomes dos pacotes compactados

Manipulando o caminho de construção Java diretamente no Explorador de Pacotes Em vez de manipular o caminho de construção Java em Projeto > Propriedades > Caminho de Construção Java, utilize as ações no menu de contexto do Explorador de Pacotes.
Por exemplo, você pode incluir novas pastas de origem, archives e bibliotecas no caminho de construção ou arquivo -in e de exclusão e pastas de uma pasta de origem.

Menu de contexto do caminho de construção

Agrupando problemas Java
Novo no 3.2
Configure a visualização Problemas para agrupar problemas Java em categorias com Agrupar por > Tipo de Problema Java no menu de visualização.

Figura da visualização Problemas com problemas agrupados

Você pode controlar se um erro configurável tende a ser fatal, ou não, na página de preferências Abre a página de preferências Construção Java > Compilador > Construção.
Indicador de tipo Java
Novo no 3.2
Ative o Indicador de Tipo Java na página de preferências Abre a página de preferências Decoração de Rótulo Geral > Aparência > Decoração de Rótulo para descobrir qual é o primeiro tipo em uma unidade de compilação ou arquivo de classe. Um adorno é mostrado para interfaces, anotações e enums, enquanto uma classe comum permanece não decorada.

Figura do Decorador de Rótulo do Indicador de Tipo Java

Diversos

Preferências específicas do projeto Todas as opções de compilador e estilo de código podem ser definidas por projeto.
Abra as páginas de propriedades do projeto com Projeto > Propriedades em um projeto ou utilize o link nas preferências do espaço de trabalho (por exemplo, a página de preferências Abre a página de preferências Estilo de Código Java > Estilo de Código) para abrir uma página de propriedades e ativar configurações específicas do projeto.

Página de propriedades do projeto com a caixa de opções 'Ativar configurações específicas do projeto'

As configurações específicas do projeto são armazenadas em um arquivo de configuração dentro do projeto (na pasta '.settings'). Quando você compartilha um projeto em uma equipe, os membros da equipe também obtêm essas configurações específicas do projeto.
Regras de Acesso
Regras de acesso fornecem a possibilidade de impor regras da API para tipos de bibliotecas referidas. Na página do caminho de construção Java (Projeto > Propriedades > Caminho de Construção Java) edite o nó 'Regras de Acesso' disponível nos projetos, archives, pastas de classe e bibliotecas referidos.
Pacotes ou tipos nessas referências podem ser classificados como:
  • Acessível
  • Desencorajado
  • Proibido
De acordo com as configurações na página de preferências Abre a página de preferências Erros/Avisos Java > Compilador > Erros/Avisos, o compilador marcará referências desencorajadas ou proibidas com avisos ou erros.

Diálogo Configuração de Regras de Acesso

JUnit Selecione um método de teste JUnit em uma visualização e escolha Executar > Teste JUnit no menu de contexto ou Executar > Executar como > Teste JUnit no menu principal. Isso cria uma configuração de ativação para executar o teste selecionado.
Ocultar a visualização JUnit até que ocorram erros ou falhas Você poderá configurar a visualização JUnit para ser aberta apenas quando existirem erros ou falhas. Desse modo, é possível manter a visualização definida como uma visualização rápida e nunca vê-la quando não houver falhas de teste. Enquanto não houver problemas nos testes, você verá este ícone Executando com êxito (o número dos pequenos quadrados verdes avançam indicando o progresso) enquanto os executa e este ícone Concluído com êxito após serem concluídos. No entanto, se ocorrerem erros ou defeitos, o ícone será alterado para Ocorreu um Defeito ou um Erro (ou Concluído com defeito ou erro se os testes forem finalizados) e a visualização JUnit será exibida.
Assistência ao Conteúdo nos Campos do Diálogo O Assistente de Conteúdo (Ctrl+Espaço) também está disponível em campos de entrada de vários diálogos Java. Procure um pequeno ícone de lâmpada ao lado do campo quando ele tiver o foco.

Diálogo Nova Classe

Posicionameto do sinal de interpolação em diálogos mostrando nomes Java
Novo no 3.2
Os campos de texto para editar nomes Java suportam posicionamento de interpolação inteligente. Utilize Ctrl+Esquerda e Ctrl+Direita para parar nos limites de caixa alternante em um nome. Utilize Ctrl+Shift+Esquerda e Ctrl+Shift+Direita para estender a seleção em pequenos passos. Utilize Ctrl+Delete para excluir a próxima e Ctrl+Backspace para excluir a parte anterior de um nome.

Posicionamento de interpolação inteligente no diálogo
Ctrl+Direita:
Posicionamento de interpolação inteligente no diálogo
Ctrl+Shift+Direita:
Posicionamento de interpolação inteligente no diálogo
gravar "Igual":
Posicionamento de interpolação inteligente no diálogo
Ctrl+Delete:
Posicionamento de interpolação inteligente no diálogo
gravar "Para":
Posicionamento de interpolação inteligente no diálogo
Definir prefixos ou sufixos para campos, parâmetros e variáveis locais Você pode configurar o prefixo ou sufixo para campos, campos estáticos, parâmetros e variáveis locais. Essas configurações na página de preferências Abre a página de preferências Estilo de Código Java > Estilo de Código são utilizadas no assistente de conteúdo, correção rápida e reformulação sempre que um nome de variável é computado.

Página de Preferências Convenções de Nomenclatura no Estilo de Código

Organizar Importações funciona não apenas em arquivos individuais Você pode chamar Origem > Organizar Importações em conjuntos de unidades de compilação, pacotes, pastas de origem ou projetos Java.
Formatar mais de um Arquivo Selecione todos os arquivos Java a serem formatados e escolha Origem > Formatar para formatá-los. A ação de formatação também está disponível em pacotes, pastas de origem ou projetos Java.
Utilizar um JRE específico para um projeto Ao criar novos projetos, o JRE incluído por padrão é aquele selecionado na página de preferências Abre a página de preferências JREs Instalados Java > JREs Instalados. Para definir um JRE específico do projeto, abra a página de propriedades do caminho de Construção Java do projeto (Projeto > Propriedades > Caminho de Construção Java), abra a página Bibliotecas, selecione 'Bibliotecas do Sistema JRE' e pressione Editar. No diálogo 'Editar Biblioteca', você pode selecionar o JRE padrão, um JRE específico do projeto ou um Ambiente de Execução para incluir em novos projetos.

Editar biblioteca de sistema JRE

Utilizar arrastar e soltar Arrastar e Soltar é uma substituição conveniente de Editar > Recortar e Editar > Colar correspondente a Editar > Copiar e Editar > Colar. Mantenha pressionada a tecla Ctrl enquanto arrasta para alterar de mover para copiar.

Informação importante:

  • Se você mover unidades de compilação Java entre pacotes por Arrastar & Soltar, o comportamento será como uma movimentação de reformulação - todas as importações ausentes serão incluídas e as referências atualizadas
  • Se você arrastar e soltar elementos de origem, como tipos e métodos, isso copiará ou moverá apenas o código-fonte correspondente - nenhuma referência será atualizada
Propagando Marcação de Reprovação O compilador Java pode ser configurado para diagnosticar a reprovação utilizando opções na página de preferências Abre a página de preferências Erros/Avisos Java > Compilador > Erros/Avisos.

Página de Preferências do Compilador

Utilizando essa configuração, o resultado é:

I.java

X.java

Y.java

Se você não puder corrigir um uso de construção reprovada, recomendamos marcar o método de anexação, o campo ou o tipo como reprovado. Dessa forma, você reconhece que substituiu uma construção reprovada, e o sinalizador de reprovação é propagado para os demais dependentes.

X.java

Y.java

Recuperando de Inconsistências Anormais No caso raro de ocorrer de uma disfunção, o JDT pode revelar algumas inconsistências, como:
  • resultados ausentes em uma Procura Java ou em Tipo Aberto
  • itens inválidos no Package Explorer

Para trazer o JDT novamente para um estado consistente, as seguintes ações precisarão ser desempenhadas nesta ordem exata:
  1. Feche todos os projetos utilizando a ação de menu Fechar Projeto do navegador
  2. Saia e reinicie o Eclipse
  3. Abra todos os projetos utilizando a ação de menu Abrir Projeto do navegador
  4. Ative manualmente uma construção de limpeza do espaço de trabalho inteiro (Projeto > Limpar...)

Depurando

Ativando do Menu de Contexto

É possível executar e depurar aplicativos Java no menu de contexto. Você pode ativar a partir de um arquivo de origem, pacote, método, tipo, etc. escolhendo Executar como (ou Depurar como) > Aplicativo Java no menu de contexto em uma visualização ou editor. Alternativamente, você pode utilizar a ligação de teclas de atalho de ativação do aplicativo Java (Alt+Shift+D, J). As ações de nível superior Executar como (ou Depurar como) também afetam a seleção atual ou o editor ativo.

Menu de contexto com opção de ativação

Avaliações no Depurador

A avaliação de snippet está disponível a partir de vários locais no depurador. A escolha de Visualização ou Inspecionar no menu de contexto do editor ou Visualização de Variáveis mostrará em um pop-up o resultado que pode ser enviado para as visualizações Visualização ou Expressões .

Resultado de uma inspeção em um pop-up

Gerenciamento de Visualização nas perspectivas de Não-Depuração

A visualização Depuração gerencia automaticamente as visualizações relacionadas com base na seleção da visualização (exibindo visualizações Java para quadros de pilha Java e visualizações C para quadros de pilha C, por exemplo). Por padrão, esse gerenciamento de visualização automática ocorre apenas na perspectiva Depuração, mas você pode ativá-lo para outras perspectivas por meio da página de preferências Gerenciamento de Visualização disponível no pull-down da barra de ferramentas Visualização Depuração.

Variáveis de Ambiente

Você pode especificar o ambiente utilizado para ativar aplicativos Java por meio da guia Ambiente.

Guia Ambiente no diálogo de configuração de ativação

Substituições de Cadeia

As variáveis são suportadas para vários parâmetros de configurações de ativação do Aplicativo Java. A maioria dos campos que suportam variáveis tem um botão Variáveis... próximo a eles, como os campos de programa e de argumentos do VM. O campo Tipo Principal também suporta variáveis; a variável ${java_type_name} permite criar uma configuração que executará o tipo selecionado.

Guia Argumentos no Diálogo de Configuração de Ativação

Estruturas Lógicas

As Estruturas Lógicas ativadas na barra de ferramentas Visualização de Variáveis apresentas estruturas alternativas para os tipos comuns. O JDT fornece visualizações lógicas para Mapas, Coletas e Conjuntos SWT. Você pode definir estruturas locais para outros tipos na página de preferências Estruturas Lógicas.

Vetor exibido como a estrutura lógica na visualização Variável

Argumentos Padrão da VM

Se você especificar o mesmo argumento para uma determinada VM freqüentemente, será possível configurar Argumentos Padrão da VM na página de preferência JREs Instalados. Isso é mais conveniente do que especificá-los para cada configuração de ativação.

Página de preferência JRE com argumento padrão especificado

Parar no Principal

Você pode utilizar Parar no Principal em uma configuração de ativação do Aplicativo Java para fazer com que o programa pare na primeira linha executável do método principal quando executá-lo no modo de depuração.

Guia Principal com a opção Parar no Principal selecionada

Pontos de interrupção condicionais Você pode utilizar pontos de interrupção condicionais em Propriedades do Ponto de Interrupção... para controlar quando um ponto de interrupção realmente descontinua a execução. Você pode especificar se deseja que o ponto de interrupção suspenda a execução apenas quando a condição é verdadeira ou quando o valor da condição é alterado.

Editor de Condição de Interrupção no Diálogo Propriedades de Interrupção

Desativando pontos de interrupção

Se você inclui e remove um ponto de interrupção com freqüência no mesmo local, considere desativar o ponto de interrupção quando ele não é necessário e ativando-o novamente quando necessário. Isso pode ser feito utilizando Desativar Ponto de Interrupção no menu de contexto do ponto de interrupção ou desmarcando o ponto de interrupção na Visualização Pontos de Interrupção.

Você também pode desativar, temporariamente, todos os pontos de interrupção utilizando a ação Ignorar Todos os Pontos de Interrupção na barra de ferramentas Pontos de Interrupção. Isso instruirá o depurador para ignorar todos os pontos de interrupção ao mesmo tempo em que manterá o estado ativado atual.

Desativar Ação Ponto de Interrupção no Menu de Contexto da Régua

Alterando valores de variáveis

Quando um encadeamento é suspenso no depurador, você pode alterar os valores de primitivas Java e Cadeias na visualização Variáveis. No menu de contexto da variável, escolha Alterar Valor de Variável. Também é possível alterar o valor digitando um novo valor na área de janela Detalhes e utilizando a ação Designar Valor no menu de contexto (ligação de teclas CTRL+S).

Alterar Valor de Variável na Área de Janela Detalhes

Valores de variáveis na ajuda instantânea Quando um encadeamento é suspenso e o cursor é colocado sobre uma variável no editor Java, o valor dessa variável é exibido como ajuda instantânea.

Foco do valor de variável no editor

Soltar no Quadro

Ao passar por seu código, você pode ocasionalmente adiantar-se muito ou saltar uma linha para a qual pretendia avançar. Em vez de iniciar novamente a sessão de depuração, você pode utilizar a ação Soltar no Quadro para voltar rapidamente para o início de um método. Selecione o quatro de pilha correspondente ao método Java que você deseja reiniciar e selecione Soltar no Quadro na barra de ferramentas da Visualização Depuração ou no menu de contexto de quatro da pilha. O ponteiro de instrução atual será redefinido para a primeira instrução executável no método. Isso também funciona para quadros de pilha não superiores.

Note que Soltar no Quadro está disponível somente ao depurar com uma VM 1,4 ou superior ou VM J9. Há algumas situações em que uma JVM não pode retirar os quadros desejados da pilha. Por exemplo, é geralmente impossível soltar no quatro inferior da pilha ou em qualquer quadro abaixo de um método nativo.

Substituição automática de código O depurador suporta a Substituição Automática de Código ao depurar com uma VM 1.4 ou superior, ou VM J9. Isso permite fazer alterações no código que você estiver atualmente depurando. Note que algumas alterações, tais como métodos novos ou excluídos, variáveis de classe ou classes internas, não podem ser trocadas a quente dependendo do suporte fornecido por uma determinada VM.
Avançando para seleções

O depurador Java permite avançar para um único método em uma série de chamadas encadeadas ou aninhadas de métodos. Simplesmente realce o método para o qual você deseja avançar e selecione Avançar para Seleção no menu de contexto do editor Java.

Esse recurso funciona em local diferentes da linha em execução atualmente. Tente depurar para um ponto de interrupção e avance para um método algumas linhas abaixo do ponteiro de instrução atual.

Rastreando a Seleção

Retenção e bloqueio do console A saída exibida no console pode ser travada para um processo específico por meio da ação Console de Pino na barra de ferramentas da visualização Console. Também existe uma ação Scroll Lock que pára a rolagem do console quando uma nova saída é anexada.
Criando itens de controle Um item de controle é uma expressão na visualização Expressões cujo valor é atualizado durante a depuração. Você pode criar itens de controle a partir do editor Java selecionando uma expressão ou variável e escolhendo Controlar a partir do menu de contexto ou no menu Executar de nível superior.
Pontos de controle

Um ponto de controle é um ponto de interrupção que suspende a execução sempre que um campo especificado é acessado ou modificado. Para configurar um ponto de controle, selecione um campo na visualização Esboço e escolha Comutar Ponto de Controle a partir de seu menu de contexto. Para configurar um ponto de controle, selecione-o na visualização Pontos de Interrupção e escolha Propriedades... em seu menu de contexto. As propriedades mais importantes para este tipo de ponto de interrupção são as caixas de opções Acesso e Modificação que controlam quando o ponto de interrupção pode suspender a execução.

Diálogo de propriedades do ponto de interrupção

Encadeamentos e Monitores

Opcionalmente, o depurador Java exibe informações do monitor na visualização Depurar. Utilize a ação Mostrar Monitores no menu drop-down da visualização Depurar para mostrar quais encadeamentos estão mantendo bloqueios e quais estão aguardando para adquirir bloqueios. Encadeamentos envolvidos em um conflito são renderizados em vermelho.

Visualização Depurar Mostrando Ciclos de Conflitos

Filtros de Etapa Os filtros de etapa previnem o depurador de ser suspenso em classes e pacotes especificados ao avançar para o código. Os filtros de etapas são estabelecidos com a página de preferências Abre a página de preferências Filtragem de Etapas Java > Depuração > Filtragem de Etapas. Quando a comutação de Utilizar Filtros de Etapa (na barra de ferramentas e no menu) estiver ativa, filtros de etapa são aplicados a todas as ações de etapa. Na visualização Depurar, o tipo de declaração ou pacote da estrutura de pilha selecionada podem ser rapidamente adicionados à lista de filtros selecionando Filtrar Tipo ou Filtrar Pacote no menu de contexto da estrutura de pilha.
Utilizando o bloco de rascunho

Se você deseja experimentar a API ou testar um novo algoritmo, muitas vezes é mais fácil utilizar uma página de bloco de rascunho Java do que criar uma nova classe. Uma página de bloco de rascunho é um contêiner para trechos aleatórios de código que você executar a qualquer momento sem um contexto. Para criar uma página de álbum de recortes, crie um novo arquivo com uma extensão .jpage (ou utilize o assistente de Abre o assistente de Novo Álbum de Recortes Nova Página de Álbum de Recortes). Digite o código que você desejar executar e, em seguida, selecione-o. Há três maneiras de executar o código:

  • Executar o código selecionado e colocar o resultado retornado em um pop-up de inspeção
  • Executar o código selecionado e colocar o resultado da Cadeia na página do bloco de rascunho

    Página Bloco de Rascunho exibindo resultado

  • Executar o código selecionado (e ignorar qualquer resultado retornado)

Estas ações estão na barra de ferramentas do ambiente de trabalho e também no menu de contexto da página do bloco de rascunho.

Editando
configurações de
ativação
Manter pressionada a tecla Ctrl e fazer uma seleção no menu drop-down Executar ou Depurar abre a configuração de ativação associada para edição. A configuração de ativação também pode ser aberta a partir do menu de contexto associado a qualquer item na visualização Depurar.
Configurações favoritas de ativação

As configurações de ativação aparecem nos menus drop-down Executar/Depurar na ordem ativada mais recentemente. No entanto, é possível forçar uma configuração de ativação para aparecer sempre na parte superior dos drop-downs, tornando a configuração uma 'favorita'. Utilize a ação Organizar Favoritos... no menu drop-down apropriado para definir suas configurações de ativação favoritas.

Formatadores de detalhes

Nas exibições Variáveis & Expressões, a área de janela de detalhes mostra uma representação expandida da variável atualmente selecionada. Por padrão, essa representação expandida é o resultado da chamada de toString() no objeto selecionado, mas você pode criar um formatador personalizado de detalhes que será utilizado escolhendo Novo Formatador de Detalhes no menu de contexto da variável. Esse formatador de detalhes será utilizado para todos os objetos do mesmo tipo. Você pode visualizar e editar todos os formatadores de detalhes na página de preferências Abre a página de preferências Formatadores de Detalhes Java > Depuração > Formatadores de Detalhes.

Diálogo Formatador de Detalhe

Executando código com erros de compilação

Você pode executar e depurar código que não foi totalmente compilado. A única diferença entre executar código com ou sem erros de compilação é que se uma linha de código com um erro de compilação for executada, ocorrerá uma das seguintes situações:

  • Se a preferência 'Suspender execução em erros de compilação' na página de preferências Abre a página de preferências Depuração Java > Depuração for configurada e você estiver depurando, a sessão de depuração será suspensa como se um ponto de interrupção tivesse sido alcançado. Observe que se a sua VM suportar a Substituição Automática de Código, você poderá corrigir o erro de compilação e retomar a depuração
  • Caso contrário, a execução será finalizada com um erro de 'compilação não resolvida'

É importante enfatizar que desde que o caminho de execução evite linhas de código com erros de compilação, você pode executar e depurar exatamente como faz normalmente.

Mudança automática de linha na visualização Variáveis A área de detalhes das exibições Variáveis e Expressões suporta a mudança automática de linha, disponível a partir do menu drop-down da visualização.

Ação Agrupamento de Palavras no menu drop-down da visualização Variáveis

Assistência ao código no depurador

A assistência ao código está disponível em vários contextos além de gravar código no editor Java:

  • Ao inserir uma condição de ponto de interrupção
  • Na área de janela Detalhes da visualização Variáveis e Expressões
  • Ao digitar um trecho de código do Formatador de Detalhes
  • Ao digitar um trecho de código da Estrutura Lógica
  • Ao digitar código em uma página de Álbum de Recortes
  • Na visualização Exibir
Detalhes da linha de comandos Você sempre pode ver a linha exata de comandos utilizada para ativar um programa no modo de execução ou depuração, selecionando Propriedades no menu de contexto de um destino do processo ou da depuração, mesmo se a ativação tiver finalizado.

Detalhes da Linha de Comandos

Hyperlinks de
rastreio de pilha

Os rastreios de pilha Java no console aparecem com hyperlinks. Quando você posiciona o mouse sobre uma linha em um rastreio de pilha, o ponteiro é alterado para uma mão. Pressionar o botão do mouse abra o arquivo de origem Java associado e posiciona o cursor na linhas correspondente. Pressionar o botão do mouse no nome da exceção na parte superior do rastreio de pilha criará um ponto de interrupção de exceção.

Rastreios de pilha na visualização Console com hyperlinks