Formatador

No editor Java, prima Ctrl+Shift+F no código para formatá-lo. Se não for definida nenhuma selecção, então, toda a fonte será formatada, caso contrário, apenas será formatada a selecção. Algumas sugestões para utilizar o formatador aparecem listadas nos parágrafos deste capítulo.

Tenha em atenção que as preferências do Formatador Java são acessíveis na página de preferências Abre a página de preferências do formatador Java Formatador Java.

Desactivar o formatador nas secções interiores

Pode desactivar/activar o formatador numa ou em várias secções no código conforme se mostra na amostra seguinte:

Exemplo do formatador Java. Algum código utilizando identificadores para desactivar e activar.

O fragmento em cima utiliza nomes de identificadores predefinidos, mas podem ser alterados no separador Identificadores desligados/ligados da página de preferências Formatador Java.

Translinear chamadas de método extremas

Desde a versão 3.6, o Formatador Java tenta agora translinear as chamadas de método extremas primeiro para ter uma melhor saída ao translinear chamadas de método imbricadas.

A seguir encontra-se um exemplo de um código formatado onde o formatador translineou a linha entre os argumentos da chamada de método extrema para manter cada chamada de método imbricada numa única linha.

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

Uma nova preferência permite-lhe desactivar esta estratégia, normalmente se pretender formatar o código como antes, então, deverá anular a selecção da preferência Preferir translinear expressões exteriores acessível no separador Translineação de linha da página de preferências Formatador Java.

Nota: Actualmente, a nova estratégia é aplicável somente em chamadas de método imbricadas, mas poderá vir a ser aplicável em outras expressões imbricadas nas versões futuras.

Resumir comentários Javadoc e de bloco

Os utilizadores podem reduzir o número de linhas de comentários de várias linhas formatados como se mostra no exemplo seguinte:

Exemplo do Formatador Java. O fragmento simples com os comentários de bloco e Javadoc formatados em menos linhas do que com o perfil predefinido.

Para activar este comportamento, anule a selecção da preferência /* e */ em linhas separadas acessível no separador Comentários da página de preferências Formatador Java.

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

Preservar quebras de linha do utilizador

Os utilizadores podem preservar as quebras de linhas não unindo as linhas em código ou comentários.

Por exemplo, as linhas já translineadas da instrução return no seguinte caso de teste:

Exemplo de Código para Formatar

serão preservadas pelo formatador quando a preferência Nunca juntar linhas é utilizada, dessa forma produz os seguintes dados de saída quando formatadas:

Código Formatado com Nunca Unir Linhas

Para activar este comportamento, seleccione a preferência Nunca unir linhas acessível nos separadores Translineação de linhas e Comentários da página de preferências do Formatador Java.

Conceitos relacionados

Editor Java
Ferramentas de programação Java (JDT)

Referência relacionada

Menu Editar
Preferências de Editor Java
Preferências do formatador