Programme de formatage

Dans l'éditeur Java, appuyez sur Ctrl+Maj+F après avoir placé votre curseur sur le code pour le formater. Si vous n'avez rien sélectionné, l'intégralité de la source est formatée ; si vous avez effectué une sélection, seule la sélection est formatée. Ce chapitre énumère quelques conseils relatifs à l'utilisation du programme de formatage.

Les préférences du programme de formatage sont accessibles dans la page de préférences Ouverture de la page de préférences du programme de formatage Programme de formatage Java.

Désactivation du programme de formatage au sein des sections

Vous pouvez désactiver ou activer le programme de formatage dans une ou plusieurs sections du code comme illustré par l'exemple ci-dessous.

Exemple du programme de formatage Java. Code utilisant les balises de désactivation et d'activation.

Le fragment ci-dessus utilise des noms de balise par défaut ; vous pouvez les modifier dans l'onglet Balises Désactivé/Activé de la page de préférences Programme de formatage Java.

Encapsulage des appels de méthode le plus vers l'extérieur

Depuis la version 3.6, le programme de formatage Java tente d'encapsuler les appels de méthode le plus vers l'extérieur en premier pour obtenir une meilleure sortie lors de l'encapsulage des appels de méthode imbriqués.

Vous trouverez ci-après un exemple de code formaté dans lequel le programme de formatage a appliqué un retour à la ligne entre les arguments de l'appel de message le plus vers l'extérieur afin de conserver chaque appel de méthode imbriqué sur une ligne.

Exemple du programme de formatage Java. Fragment simple avec appels de méthode imbriqués formatés.

Une nouvelle préférence permet de désactiver cette stratégie, par exemple si vous voulez formater le code comme avant. Dans ce cas, désélectionnez la préférence Privilégier le retour à la ligne des expressions externes accessible dans l'onglet Retour à la ligne de la page de préférences Programme de formatage Java.

Remarque : actuellement, la nouvelle stratégie ne s'applique qu'aux appels de méthode imbriqués ; toutefois, elle pourra être étendue aux autres expressions imbriquées dans des versions ultérieures.

Condensation des commentaires de bloc et Javadoc

Les utilisateurs peuvent réduire le nombre de lignes des commentaires formatés sur plusieurs lignes comme illustré par l'exemple ci-dessous.

Exemple du programme de formatage Java. Fragment simple contenant des commentaires de bloc et Javadoc formatés sur un nombre de lignes inférieur à celui du profil par défaut.

Pour activer ce comportement, désélectionnez la préférence /* et */ sur des lignes distinctes accessible dans l'onglet Commentaires de la page de préférences Programme de formatage Java.

Le même type de préférence est disponible pour les commentaires Javadoc.

Conservation des retours à la ligne définis par l'utilisateur

Les utilisateurs peuvent conserver les retours à la ligne en ne joignant pas les lignes dans le code ou les commentaires.

Par exemple, les lignes pour lesquels un retour à la ligne est déjà appliqué de l'instruction return dans le scénario suivant

Exemple de code à formater

sont conservées par le programme de formatage si la préférence Ne jamais joindre les lignes est sélectionnée, générant ainsi la sortie suivante après formatage :

Code formaté avec l'option Ne jamais joindre les lignes

Pour activer ce comportement, sélectionnez la préférence Ne jamais joindre les lignes accessible dans les onglets Retour à la ligne et Commentaires de la page de préférences Programme de formatage Java.

Concepts connexes

Editeur Java
Outils de développement Java (JDT)

Référence connexe

Menu Editer
Préférences de l'éditeur Java
Préférences du programme de formatage