Formatador

No editor Java, pressione Ctrl+Shift+F no código para formatá-lo. Se nenhuma seleção estiver configurada, toda a origem será formatada, em vez de ocorrer formatação apenas na seleção. Algumas dicas sobre como usar o formatador estão listadas nos parágrafos deste capítulo.

Observe que as preferências do Formatador Java estão acessíveis na página de preferências Abre a página de preferências Formatador Java Formatador Java.

Desativando o Formatador nas Seções

É possível desativar/ativar o formatador em uma ou várias seções no código, como mostrado na amostra abaixo:

Exemplo do formatador Java. Algum código usando tags de desativação e ativação.

O fragmento acima usa nomes de tag padrão, mas eles podem ser alterados na guia Desativar/Ativar Tags da página de preferências Formatador Java.

Quebrar Chamadas de Métodos Mais Externas

Desde a versão 3.6, o formatador Java tenta quebrar as chamadas de método mais externas primeiro, para ter uma melhor saída ao quebrar chamadas de métodos aninhadas.

A seguir, um exemplo do código formatado no qual o formatador quebrou a linha entre os argumentos da chamada de mensagem mais externa para manter cada chamada de método aninhada em uma única linha:

Exemplo de formatador Java. O fragmento simples com as chamadas de método aninhadas formatadas.

Uma nova preferência permite desativar esta estratégia, geralmente se você deseja formatar seu código como antes e depois desmarcar a preferência Preferir Agrupamento de Expressões Mais Externas acessível na guia Agrupamento de Linha da página de preferências Formatador Java.

Nota: Atualmente, a nova estratégia se aplica apenas a chamadas de método aninhadas, mas que podem ser estendidas para outras expressões aninhadas em versões futuras.

Condensar Comentários de Bloco e Javadoc

Os usuários podem reduzir o número de linhas de comentários com várias linhas formatadas, como mostrado no exemplo abaixo:

Exemplo do formatador Java. O fragmento simples com os comentários de blocos e Javadoc formatados com menos linhas do que com o perfil padrão.

Para ativar este comportamento, desmarque a preferência /* e */ em linhas separadas acessível na guia Comentários da página de preferências Formatador Java.

O mesmo tipo de preferência também está disponível para os comentários de Javadoc.

Preservar Quebras de Linha do Usuário

Os usuários podem preservar as quebras de linha não unindo as linhas no código ou nos comentários.

Por exemplo, as linhas já agrupadas da instrução return nas etapas de teste a seguir:

Exemplo de Código a Formatar

serão preservadas pelo formatador quando a preferência Nunca Unir Linhas for usada, produzindo, assim, a seguinte saída quando formatadas:

Código Formatado com Nunca Unir Linhas

Para ativar este comportamento, marque a preferência Nunca Unir Linhas acessível nas guias Agrupamento de Linha e Comentários da página de preferências Formatador Java.

Conceitos relacionados

Editor Java
JDT (Ferramentas de Desenvolvimento Java)

Referência relacionada

Menu Editar
Preferências do Editor Java
Preferências do Formatador