Dicas e Sugestões

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
Novo no 3.0

Para excluir determinados tipos a fim de que não sejam exibidos na assistência ao conteúdo, utilize o recurso de filtro configurado na página de preferências Java > 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.
Você poderá comutar temporariamente o comportamento enquanto estiver no diálogo se seleção da assistência ao conteúdo, pressionando e segurando a tecla Ctrl enquanto seleciona o preenchimento.
Assistência ao Conteúdo Incremental Marque Inserir Prefixos Comuns Automaticamente na guia de preferências Java > Editor > Sintaxe para utilizar o preenchimento incremental de estilo shell no editor Java. Se os preenchimentos disponíveis não tiverem um prefixo comum, o pop-up de sugestão será exibido.
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
Novo no 3.0
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 a fim de obter as sugestões 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 (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
Novo no 3.0
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
Novo no 3.0
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
Novo no 3.0
É 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 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 Arquivo Para 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
Novo no 3.0
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
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 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:

for (int ${index} = ${array}.length - 1; ${index} >= 0; ${index}--){
   ${cursor}
}
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 personalizado na página de preferência Java > Editor > Assistência ao Código (consulte a caixa de opções Preencher nomes de argumentos na conclusão do método.) 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 Java > Editor > Assistência ao 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?
Novo no 3.0
Você pode ativar o suporte de verificação ortográfica no editor Java na página de preferências Java > Editor > 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 sugestão 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 exigido é apenas uma lista de palavras separadas por novas linhas, e as Correções Rápidas permitem incluir novas palavras no dicionário ativo. 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 Java > Estilo de Código > Gabaritos de Código permite que você personalize os códigos e os comentários gerados de um modo semelhante aos gabaritos normais. Esses gabaritos de código são utilizados sempre que um código é gerado. (Esses novos gabaritos substituem os gabaritos 'filecomment' e 'typecomment' utilizados anteriormente para a geração do código no R2.1.)

Página de preferências Gabaritos de Código

A caixa de opções Incluir Comentários Automaticamente...' permite que você decida se os recursos que criam novos métodos ou tipos incluem comentários automaticamente ou se eles são incluídos explicitamente com 'Incluir Comentário Javadoc'.
Classificar Membros Você pode Classificar Membros de uma unidade de compilação Java, de acordo com a ordem da categoria definida na página de 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" muito +
           " longa.";

Esse comportamento pode ser personalizado na página de preferência Java > Editor > Digitação.

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

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

Note que o Posicionamento do ponto-e-vírgula inteligente e o Posicionamento da chave inteligente são desativadas por padrão. Quando Fechar Colchetes e Parênteses está ativado, você geralmente tem que pressionar uma tecla adicional para posicionar o cursor atrás do colchete ou do parênteses inserido automaticamente antes de digitar uma chave de abertura ou um ponto-e-vírgula. O Posicionamento do ponto-e-vírgula inteligente e o Posicionamento de chave inteligente posicionam automaticamente o ponto-e-vírgula ou a chave atrás do colchete ou do parênteses inserido. Você pode desfazer esse posicionamento automático pressionando backspace à direita, posteriormente.

Corrigir Recuo de Código com um Traço de Tecla
Novo no 3.0
Um recurso útil é Origem > Corrigir Recuo. Selecione o código em que os recuos são incorreto e chame a ação.
Menus Rápidos para Ações de Origem e de Reformulação
Novo no 3.0

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 ou Alt+Shift+T para o menu de reformulaçã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 definição é ativada na página de preferências Java > Compilador.

Página de preferência 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
Novo no 3.0
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 a partir da guia de preferências Java > Compilador > Javadoc (ou definido para um projeto individual utilizando Projeto > Propriedades > Compilador Java > Javadoc).

Página de preferências Javadoc

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

Problemas detectados no Javadoc

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

De modo alternativo, utilize o novo recurso Marcar Ocorrências para realçar, de forma dinâmica, as ocorrências. 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 quiser localizar referências no Javadoc, desative esse comportamento desmarcando Processar Comentários de Javadoc da página de preferências Java > Compilador > Javadoc.
Cadeias de Chamada de Método de Rastreio com a Hierarquia de Chamada
Novo no 3.0

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 > Java > Editor > Navegação.
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
Novo no 3.0
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 Contorno Rápido

Hierarquia no Local
Novo no 3.0
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
Novo no 3.0
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). Quando o realce avançado é ativado por meio da guia de preferências Java > Editor > Sintaxe, as opções de realce avançado são exibidas na lista.

Um exemplo de realce avançado.

Também há opções para operadores e colchetes de realce.

Regiões Inicialmente Compactadas
Novo no 3.0
A Compactação Java Padrão permite definir as regiões inicialmente compactadas na guia Compactação da página de preferências Java > Editor. As opções suportadas são: comentários, tipos internos, métodos e importações.

Página de preferência Compactação

Marcar Ocorrências
Novo no 3.0
Ao trabalhar no editor, ative Marcar Ocorrências na barra de ferramentas (Figura do Botão Marcar Ocorrências da Barra de Ferramentas) ou pressione (Alt+Shift+O).Você verá um arquivo, em que há uma referência de variável, método ou tipo.
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
Defina 'marcar ocorrências' em 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
Novo no 3.0
Utilize os botões da barra de ferramentas Anotação Seguinte / Anterior ou Navegar > Anotação Seguinte (Ctrl+.) e Navegar > Anotação Anterior (Ctrl+,) para navegar entre as 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 Java > Marcações de Tarefas para configurar quaisquer outras marcações especiais (como "FIXME") que você gostaria de monitorar na lista de tarefas.

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

Selecionar Variáveis no final de Diálogos Abrir e Ir para Os diálogos Abrir e Ir para agora suportam o caractere final '<'. Para ver todos os tipos no diálogo Abrir Tipo que terminam com "Test", insira o padrão "*Test<".
Se '<' não estiver incluído no padrão, um '*' será anexado ao padrão. Se inserir "*Test" no diálogo Abrir Tipo, você verá todos os tipos contendo "Test" em alguma parte no nome do tipo.
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 modificadores em Preferências > Java > Editor > Focos.
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

Visualização Declaração
Novo no 3.0
Há uma nova visualização Declaração (Janela > Mostrar Visualização > Outra > Java > Declaração) que mostra a origem do elemento selecionado no editor Java ou em uma visualização Java.

Visualização Declaração

Visualização Javadoc
Novo no 3.0
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

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.
Descobrir onde um método está implementado na hierarquia 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

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 Preferências > Java > Aparência

Configuração padrão de compactação na página de preferência de aparência Java

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

Nomes dos pacotes compactados

Diversos

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 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.

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. Se os arquivos tiverem diferenças, eles serão abertos em um Editor de Comparação. A área de janela superior mostra as propriedades afetadas; dar um clique duplo em uma delas mostra a origem da propriedade 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 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

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 Java > Estilo de Código são utilizadas na assistência ao conteúdo, na correção rápida e na reformulação sempre que um nome de variável é computado.

Convenções de nome na página de preferências de geração de códigos

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
Novo no 3.0
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

Você também pode definir configurações específicas do projeto para as marcações de Tarefa Java (tarefas TODO).
Utilizar um JRE específico para um projeto Ao criar novos projetos, o JRE incluído por padrão é aquele selecionado em 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 a reprovação utilizando as opções na página Java > Compilador > Avançado.

Página de preferência 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

Novo no 3.0

Agora, a ativação está disponível no menu de contexto de muitos itens. Você pode ativar a partir de um arquivo de origem, pacote, método, tipo etc escolhendo Executar (ou Depurar) > Aplicativo Java no menu de contexto.

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 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

Novo no 3.0

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

Novo no 3.0

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

Novo no 3.0

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. 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.

Estruturas Lógicas

Novo no 3.0

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.

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

Argumentos Padrão da VM

Novo no 3.0

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.

Diálogo de propriedades do ponto 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.

Ação Desativar Pontos de Interrupção no menu de contexto de 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).

Diálogo Alterar Valor de Variável

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.

Avançando 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 Contorno 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

Visualização Encadeamentos e Monitores

A visualização Encadeamentos e Monitores mostra quais encadeamentos estão retendo travas e quais estão aguardando para obter travas.

Visualização Monitores mostrando os ciclos de conflito

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 o comutador Utilizar Filtros de Etapa (na barra de ferramentas e no menu de depuração) está ativo, os 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 do bloco de rascunho, crie um novo arquivo com a extensão .jpage (ou utilize o assistente Novo - Java > Executar/Depurar Java > Página Bloco de Rascunho). 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 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 workbench 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 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 Java > Depurar for definida 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 para um ponto de interrupção
  • Na área de janela Detalhes da visualização Variáveis & Expressões
  • Ao inserir um trecho de código do Formatador de Detalhes
  • Ao inserir código em uma página de Bloco de Rascunho
  • 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 comando

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 altera para uma mão e o rastreio de pilha é sublinhado. 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

Avisos jurídicos