Formateador

En el editor Java pulse Control+Mayús+F en el código para formatearlo. Si no se establece ninguna selección, se formatea todo el código fuente, de lo contrario sólo se formateará la selección. En los párrafos de este capítulo se hacen algunas sugerencias para utilizar el formateador.

Tenga en cuenta que puede acceder a las preferencias del Formateador Java en la página de preferencias del Abre la página de preferencias del Formateador Java Formateador Java.

Inhabilitar secciones dentro del formateador

Puede inhabilitar/habilitar el formateador dentro de una o varias secciones en el código, tal como se muestra en el ejemplo siguiente:

Ejemplo de formateador Java. Código que utiliza códigos de habilitación e inhabilitación.

El fragmento de código anterior utiliza nombres de códigos predeterminados pero estos se pueden cambiar en la pestaña Códigos de activación/desactivación de la página de preferencias Formateador Java.

Acomodar las llamadas de método más externas

Desde la versión 3.6, el formateador Java intenta ahora envolver las llamadas de método más externas primero para tener una salida mejor al envolver llamadas de método anidadas.

A continuación se proporciona un ejemplo de un código formateado en el que el formateador ha acomodado la línea entre los argumentos de la llamada de mensaje más externa para mantener cada llamada de método anidado en una sola línea:

Ejemplo de formateador Java. El fragmento de código más simple con las llamadas de método anidadas formateadas.

Una preferencia nueva permite inhabilitar esta estrategia, normalmente si desea formatear su código como antes, a continuación deseleccione la preferencia Preferir acomodar expresiones externas a la que se accede en la pestaña Acomodación de línea de la página de preferencias Formateador Java.

Nota: actualmente, la estrategia nueva sólo se aplica a llamadas de método anidadas pero eso puede ampliarse a otras expresiones anidadas en próximas versiones.

Condensar comentarios Javadoc y de bloque

Los usuarios pueden reducir el número de líneas en comentarios de varias líneas formateados tal como se muestra en el ejemplo siguiente:

Ejemplo de formateador Java. El fragmento de código simple con los comentarios de bloque y Javadoc formateados con menos líneas que con el perfil predeterminado.

Para activar este comportamiento, deseleccione la preferencia /* y */ en líneas distintas a la que puede acceder en la pestaña Comentarios de la página de preferencias Formateador Java.

La misma clase de preferencias también está disponible para los comentarios Javadoc.

Conservar saltos de línea de usuario

Los usuarios pueden conservar los saltos de línea dejando sin unir las líneas en el código o los comentarios.

Por ejemplo, las líneas ya acomodadas de la sentencia return en el caso de prueba siguiente:

Ejemplo de código a formatear

se conservarán cuando se utiliza la preferencia Nunca unir líneas, por lo que se genera la salida siguiente cuando se formatea:

Código formateado con Nunca unir líneas

Para activar este comportamiento seleccione la preferencia Nunca unir líneas a la que se puede acceder en las pestañas Acomodación de línea y Comentarios de la página de preferencias Formateador Java.

Conceptos relacionados

Editor Java
Herramientas de desarrollo Java (JDT)

Consulta relacionada

Menú Editar
Preferencias del editor Java
Preferencias de formateador