Java Code Formatter

Cet outil formate automatiquement le code source Java selon un style défini. Les utilisateurs cibles sont les développeurs, les réviseurs de code et les enseignants qui ont besoin d’un style déterministe pour de grands bases de code. Il résout les problèmes d’indentation incohérente, d’enveloppement des lignes et de placement des imports qui ralentissent les revues. Il accepte des sources Java brutes et retourne un code reformatté sans changer la sémantique. Les commentaires et les positions des génériques restent intacts, et les conventions Java courantes (inspirées JLS) sont prises en charge. Les utilisateurs spécifient une largeur de ligne, un style de crochets et un ordre des imports. Il peut fonctionner comme service ou bibliothèque et s’intègre dans les pipelines CI pour imposer le formatage lors des commits et des pull requests. Il prend en charge des constructions modernes (génériques, annotations, chaînes multi-lignes) et maintient les commentaires attachés à leurs blocs environnants.
Conceptuellement, le formatter tokenize l’entrée, construit une représentation orientée langage et applique un ensemble de règles qui reformattent les lignes, alignent les jetons et organisent les imports (y compris les imports statiques). Il conserve la sémantique tout en ajustant les espaces, l’alignement et l’indentation. Il prend en charge plusieurs profils de configuration et peut exporter un profil pour réutilisation. La première passe effectue une analyse structurelle, suivie de passes de reformattage ciblées pour l’indentation, les retours à la ligne et les accolades. L’algorithme est idempotent: reformater la même entrée avec le même profil donne le même résultat, assurant des résultats reproductibles dans les équipes et les environnements.