Dicas e Sugestões

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

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

Tipos de Supressão na Assistência ao Código

Para evitar que determinados tipos apareçam no assistente de conteúdo, utilize o recurso de filtro de tipo configurado na página de preferências Janela > Preferências > Java > Aparência > Filtros de Tipo. Os tipos que correspondem a um desses padrões de filtro não serão exibidos no diálogo Abrir Tipo e não estarão disponíveis para a assistência ao código, a correção rápida e para organizar as importações. Esses padrões de filtro não afetam as visualizações Package Explorer e Hierarquia de Tipo.

Página Preferências do Filtro de Tipo
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 depois do nome de tipo da declaração, chame Editar > Assistência ao Conteúdo ou pressione Ctrl+Space.

Sugestões para nomes de campo

Se você utilizar um prefixo ou um sufixo de nome para os campos, as variáveis locais ou os parâmetros de método, certifique-se de especificá-lo na página de preferências Estilo do Código (Janela > Preferências > 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.
Assistência ao Código para Comutar entre Inserir e Substituir Quando a assistência ao código é chamada 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 em Janela > Preferências > Java > Editor > Assistência ao Código.
É 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 esse comportamento, desmarque a configuração na página de preferências Janela > Preferências > Java > Editor > Assistente de Código.
Diálogo Criar Getter 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 um sufixo de nome, certifique-se de especificá-lo na página de preferências Estilo de Código (Janela > Preferências > Java > Estilo de Código).
Utilizar Assistência ao Conteúdo para Criar Getter 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.
Assistência ao código para criar um setter
Excluir Getters e Setters Junto 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 um sufixo de nome para os campos, certifique-se de especificá-lo na página de preferência Estilo de Código (Janela > Preferências > 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 delegado
Utilizar Arrastar & Soltar para Reformulação Você pode mover unidades de compilação Java entre pacotes utilizando Arrastar & Soltar - todas as importações ausentes serão adicionadas e as referências atualizadas.
Utilizar Arrastar & Soltar para mover e copiar elementos de código Java Você pode mover e copiar elementos Java, como métodos e campos, utilizando Arrastar & Soltar. Isso não acionará a reformulação - apenas o código será copiado ou movido.
Utilizar Gabaritos para criar um método Você pode definir um novo gabarito (Janela > Preferências > Java > Editor > Gabaritos) que contenha um stub de método. Os gabaritos são mostrados juntos com as sugestões da Assistência ao Conteúdo (Ctrl+Espaço).
Também há gabaritos 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 gabarito 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 em que deseja incluir o novo construtor, utilize a assistência ao código depois de digitar as primeiras letras do nome do construtor.
Criar construtor na assistência ao código
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'

Renomear no ArquivoPara efetuar uma renomeação rápida que não exige uma 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 gabaritos) 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'

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 mais instruções no bloco try, selecione as instruções e utilize Origem > Demarcar com Bloco try/catch. Você também pode selecionar instruções individuais utilizando Editar > Expandir Seleção para e selecionando Anexando, Próximo 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ê poder 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
Novo no 3.1
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
Novidade no 3.1
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
Novidade no 3.1
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 de teclas para obter mais correções rápidas 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 pressione Ctrl+1 (Editar > Correção Rápida). Isso lista todos os gabaritos que contêm a variável ${line_selection}.

Assistência rápida 'Demarcar com gabaritos'

Os gabaritos podem ser configurados em Janela > Preferências > Java > Editor > Gabaritos. Edite os gabaritos correspondentes ou defina seus próprios gabaritos para personalizar o código resultante.
Criar seus próprios gabaritos

Para criar seus próprios gabaritos, vá para a página de preferências Janela > Preferências > Java > Editor > Gabaritos e pressione o botão Novo para criar um gabarito. Por exemplo, um gabarito a ser iterado em ordem inversa em uma matriz seria semelhante a este:

Gabarito Mostrando Iteração Retroativa
Assistência ao código pode inserir nomes de argumentos automaticamente

Você pode permitir que a assistência ao código insira nomes de argumentos automaticamente na conclusão do método. Esse comportamento pode ser customizado na página de preferências Janela > Preferências > Java > Editor > Assistente de Código (consulte a caixa de opções Preencher Nomes de Argumentos na Conclusão). Por exemplo, ao selecionar a segunda entrada aqui,

janela de assistência ao código

a assistência ao código insere automaticamente os nomes de argumentos:

Assistência ao código inseriu nomes de argumentos

Você pode utilizar a tecla Tab para navegar entre os nomes inseridos .

A assistência ao código também pode sugerir nomes de argumentos - com base nos seus tipos declarados. Isso pode ser configurado por meio da caixa de opções Sugerir Nomes de Argumentos Preenchidos na página de preferências Janela > Preferências > Java > Editor > Assistente de Código.

Inserir Argumentos de Tipo Automaticamente
Novo no 3.1
A ativação de Preencher Nomes de Argumentos na Conclusão na página de preferências Janela > Preferências > Java > Editor > Assistente de Código também é útil ao trabalhar com tipos com parâmetros no J2SE 5.0.
Assistente de Código em um Tipo com Parâmetros
resulta em
Argumento de Tipo Suposto e Inserido pelo Assistente de Código
Remover instrução de demarcação Para remover uma instrução ou bloco de demarcação, posicione o cursor no colchete de abertura 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 de verificação de ortografia no editor Java na página de preferências 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 > Anexando Elemento na barra de menus - a seleção será expandida para o menor elemento de sintaxe Java que contém 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 de fechamento Ctrl+Shift+P (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 gabaritos para o novo comentário podem ser configurados em Janela > Preferências > Java > Estilo de Código > Gabaritos de Código
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 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 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 Janela > Preferências > Java > Estilo de Código > Gabaritos de Código permite que você customize o código e os comentários gerados de modo semelhante ao de gabaritos normais. Esses gabaritos de código são utilizados sempre que um código é gerado.
Página de Preferências Gabaritos de Código

Desde o 3.1, é possível projetar gabaritos de código específicos, que também serão compartilhados na equipe se o projeto for compartilhado. Abra as Propriedades no projeto para ativar configurações específicas do projeto.
Criar Comentários no Código Comentários podem ser incluídos implicitamente com Origem > Incluir Comentário (Ctrl+Shift+J) ou automaticamente por vários assistentes, recriações ou correções rápidas.
Configure os gabaritos de comentários na página de preferências Janela > Preferências > Java > Estilo de Código > Gabaritos de 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ários' nos novos assistentes de tipo Java) ou por meio da caixa de opções 'Incluir Novos Comentários Automaticamente para Novos Métodos e Tipos' da página Janela > Preferências > 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 categorias definida na página de preferências Janela > Preferências > Java > Aparência > Ordem de Classificação de Membros.
Você localizará a ação sob Origem > Classificar Membros
Quebrar Cadeias

Você pode quebrar os literais de Cadeia quando os editar. Por exemplo, se você tiver 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 Janela > Preferências > 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 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 > Recuo Correto ou Ctrl+I. Selecione o código onde os recursos estão incorretos e chame a ação.
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 obter o menu de origem rápido ou Alt+Shift+T para obter o menu de recriação rápida.

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 Janela > Preferências > Java > Compilador > Erro/Avisos (ou configure para um projeto individual utilizando Projeto > Propriedades > Compilador Java > Erro/Avisos).

Página de Preferências do Compilador

Essas definições também são detectadas enquanto você digita 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 Janela > Preferências > Java > Compilador > Javadoc (ou configure 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
New in 3.1
No J2SE 5.0 você pode suprimir todos os avisos 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 de SuppressWarnings para que o aviso não seja mostrado para esse método.
Correção Rápida para Incluir Anotação SuppressWarning

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 específico de retorno, utilize "* <tipo de retorno>" da seguinte forma:

  • 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

Remover Resultados de Javadoc da Procura Java Por padrão a Procura Java localiza as referências no código Java e no Javadoc. Se você não desejar localizar referências dentro do Javadoc, poderá filtrar essas correspondências ativando o 'Filtro Javadoc' no menu de visualização (símbolo do triângulo) da visualização de procura.
Cadeias de Chamada de Método de Rastreio com a Hierarquia de Chamada

Você já procurou referências para métodos várias vezes? Utilize a nova Hierarquia de Chamada para acompanhar cadeias de chamada longas ou complexas sem perder o contexto original; apenas 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 Há duas maneiras de abrir um elemento de sua referência no editor Java.
  • Selecione a referência no código e pressione F3 (Navegar > Abrir Declaração)
  • Pressione Ctrl e mova o ponteiro do mouse sobre a referência
Navegação no estilo hyperlink
A navegação no estilo hyperlink pode ser configurada em Preferências > Geral > > Editores > Editores de Texto > Suportar Navegação no Estilo Hyperlink.
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 > Esboço Rápido) para exibir um esboço no local do arquivo de origem atual.

Esboço no local

Esboços no Local Mostram Membros Herdados Pressione Ctrl+O ou Ctrl+F3 novamente para incluir membros herdados em um esboço Local aberto. Os membros herdados têm uma etiqueta cinza. Filtre e classifique o esboço 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 rápida'. Coloque o cursor na chamada de método e pressione Ctrl+T (Navegar > Hierarquia Rápida). A visualização mostra todos os tipos que implementam o método com um ícone completo.

Visualização Hierarquia Rápida

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). Consulte as várias opções na página de preferências Janela > Preferências > Java > Editor > Coloração de 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. Consulte a página de preferências Janela > Preferências > Java > Editor > Incluindo 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.
Faça o ajuste fino de 'Marcar Ocorrências' na Janela > Preferências > Java > Editor > Marcar Ocorrências..
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 Janela > Preferências > Compilador Java > Tags de Tarefa para configurar qualquer outra tag especial (como "FIXME") que você gostaria de rastrear 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
Novo no 3.1
  • Para localizar tipos rapidamente, apenas digite as letras maiúsculas do nome do tipo: IOOBE finds IndexOutOfBoundsException
  • Para ver todos os tipos terminados com um determinado sufixo, por exemplo, todos os 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 em Janela > Preferências > Java > Editor > Focos.
Assinatura Inferida de Método Genérico
Novidade no 3.1
Você pode utilizar foco para mostrar a assinatura inferida de 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, expanda o nó da biblioteca na qual você pode editar o nó 'Localização do Javadoc'. A documentação pode estar localizada no sistema de arquivos em uma pasta ou archive ou em um servidor 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).

Exibições Java

Organizando o Espaço de Trabalho com Muitos Projetos
Novidade no 3.1
Utilize Mostrar > Conjuntos de Tarefas no menu de visualização do Explorador de Pacotes para ativar um novo modo que mostre os conjuntos de tarefas 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 Selecionar Conjuntos de Tarefas no menu de visualização Explorador de Pacotes para configurar quais conjuntos de tarefas são mostrados. O diálogo permite criar novos conjuntos de tarefas Java, definir 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 (Janela > Mostrar Visualização > Outra > 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 Há uma visualização Javadoc (Janela > Mostrar Visualização > Outra > 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

Visualização Hierarquia de Tipos e Implementações / Definições de Método 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, verificar 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, observa-se que ele contém métodos que foram definidos no Objeto, Coleção 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

Layout hierárquico vs. plano de pacotes Uma opção na visualização Pacotes Java (e visualização Package Explorer) permite alterar o modo como os pacotes são exibidos. Hierárquico exibe os pacotes em uma árvore, com subpacotes abaixo dos pacotes; Plano exibe-os na disposição padrão, como uma lista plana 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. Isso mostra a visualização Pacotes que contém um pacote lógico.

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

Compactar Nomes de Pacotes Se os nomes dos pacotes forem muito longos, será possível configurar um nome compactado para ser exibido nos visualizadores. A configuração do padrão de compactação é feita em > Janela > Preferências > 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
Novidade no 3.1
Em vez de manipular o caminho de construção Java no 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 Caminho de Construção

Diversos

Preferências Específicas do Projeto
Novidade no 3.1

Todo o estilo de código e opções do compilador agora podem ser definidos 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, Janela > Preferências > Java > Estilo de Código) para abrir uma página de propriedades do projeto e ativar configurações específicas do projeto.
Página de propriedades do projeto com 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
Novidade no 3.1
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 em Janela > Preferências > Java > Compilador > Erros/Avisos, o compilador marcará referências desencorajadas e 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ê pode deixar a visualização JUnit aberta apenas quando há 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. Esse comportamento pode ser configurado por meio da página de preferências Janela > Preferências > Java > JUnit.
Assistência ao Conteúdo nos Campos do Diálogo Agora, a Assistência ao Conteúdo (Ctrl+Space) também está disponível nos campos de entrada de vários diálogos Java. Procure o pequeno ícone de lâmpada elétrica ao lado do campo quando ele tiver foco.

Diálogo Nova Classe

A Assistência ao Conteúdo é, por exemplo, implementada nos assistentes Nova Classe Java, Nova Interface Java e Novo Teste JUnit, bem como nos diálogos de reformulação para Alterar Assinatura de Método e mover membros estáticos.

As reformulações Extrair Variável Local, Converter Variável Local para Campo e Introduzir Parâmetro fornecem sugestões da assistência ao conteúdo para o novo nome do elemento.

Definir prefixos ou sufixos para campos, parâmetros e variáveis locais Além de configurar o prefixo ou sufixo para campos, você também pode especificar o prefixo ou sufixo para campos estáticos, parâmetros e variáveis locais. Essas configurações na página de preferências Janela > Preferências > Java > Estilo de Código são utilizadas no assistente de conteúdo, na correção rápida e na recriaçã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 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 definições do compilador específicas do projeto Cada projeto pode utilizar as configurações globais do compilador ou definir configurações específicas do projeto. Selecione o projeto e abra a página do compilador Java nas propriedades de projeto (Projeto > Propriedades > Compilador Java)

Configurações do compilador Java específicas do projeto

Utilizar um JRE específico para um projeto Ao criar novos projetos, o JRE que é incluído por padrão é aquele selecionado em Janela > Preferências > 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 ou um JRE específico do projeto para ser incluído em novos projetos.

Editar biblioteca de sistema JRE

Propagando Marcação de Reprovação O compilador Java pode ser configurado para diagnosticar reprovação utilizando opções na página Janela > Preferências > Java > Compilador > Avançado.

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 torná-lo consistente novamente, as seguintes ações devem ser executadas nessa 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 fragmento está disponível a partir de vários locais no depurador. A escolha de Exibir ou Inspecionar no menu de contexto do editor ou Visualização 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ático ocorre somente na perspectiva Depuração, mas também pode ser ativado para outras perspectivas por meio da página de preferência Gerenciamento de Visualização do menu de opções Visualização Depuração da barra de ferramentas.

Variáveis de Ambiente

Agora, você pode especificar o ambiente utilizado para ativar os 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 agora são suportadas por muitos parâmetros das configurações de ativação dos aplicativos 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 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. Você também pode 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 tecla CRTL-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

Controlando
o 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. Há também uma ação Trava de Rolagem que impede o console de rolar automaticamente quando uma nova saída é anexada.

Visualização Console com drop-down de processo

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 uma variável especificada é acessada ou modificada. Para definir um ponto de controle, selecione uma variável na visualização Esboço e escolha Comutar Ponto de Controle do 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 etapa são estabelecidos em Janela > Preferências > Java > Depurar > 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 álbum de recortes

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

  • Executar o código selecionado e colocar o resultado na visualização Expressões
  • Executar o código selecionado e colocar o resultado da Cadeia na página do álbum de recortes

    Página Álbum de Recortes exibindo resultado

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

Estas ações estão na barra de ferramentas do workbench e também no menu de contexto da página do álbum de recortes.

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 Janela > Preferências > Java > Depurar > 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 Janela > Preferências > Java > Depurar estiver configurada e você estiver depurando, a sessão de depuração será suspensa como se um ponto de interrupção tivesse sido atingido. 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

Pop-up da assistência ao código da visualização Visualização

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