Travailler avec la configuration YAML et Java Properties
Ce que fait ce convertisseur
YAML et les fichiers .properties de Java sont deux façons d'écrire la même configuration. Les fichiers properties stockent une paire clé=valeur plate par ligne et utilisent des points pour suggérer la hiérarchie (server.servlet.context-path=/api). YAML exprime cette même hiérarchie par une indentation et une imbrication réelles. Cet outil lit l'un ou l'autre format, détermine lequel vous avez collé et le réécrit dans l'autre : il déploie les clés à points en une arborescence imbriquée, ou aplatit une arborescence en chemins à points.
Comme la conversion est bidirectionnelle et repose sur la structure détectée plutôt que sur un gabarit fixe, un fichier peut faire l'aller-retour (YAML → Properties → YAML) avec les mêmes clés et valeurs. Pour que les listes restent des listes, choisissez Indexé ([0]) dans Format de Tableau : avec le style par défaut, séparé par des virgules, une liste revient sous forme d'une seule valeur texte et les lignes # se retrouvent en haut.
Quand l'utiliser
Le cas le plus courant est un projet Spring Boot qui migre entre application.properties et application.yml. Les équipes commencent généralement avec properties et passent à YAML lorsque la configuration devient assez profonde pour que les clés à points deviennent difficiles à lire. Aller dans l'autre sens est tout aussi utile lorsqu'un outil ou un pipeline de déploiement attend des properties plates.
Il est aussi pratique pour comparer rapidement deux configurations, convertir un extrait de documentation dans le format réellement utilisé par votre projet, ou normaliser l'indentation et le style des tableaux avant un commit.
Exemple : un bloc serveur
Les lignes properties server.port=8080 et server.servlet.context-path=/api deviennent un bloc YAML imbriqué où server contient port: 8080 et une clé servlet contenant context-path: /api. Reconvertissez-le et les clés à points réapparaissent à l'identique. Les nombres comme 8080 restent sans guillemets afin de conserver leur type entier plutôt que de devenir des chaînes.
Remarques de format et cas particuliers
Avec Préserver Commentaires activé (par défaut), les lignes qui commencent par # sont déplacées en haut du résultat ; un commentaire en fin de ligne n'est pas conservé, et un commentaire ne reste pas à côté de la clé qu'il décrivait. De YAML vers Properties, une liste devient une seule valeur séparée par des virgules (tools=a,b) ou des lignes indexées (tools[0]=a, tools[1]=b) ; de Properties vers YAML, les lignes indexées deviennent une liste YAML à tirets. L'indentation réglable et les guillemets des chaînes (auto, toujours, jamais) permettent de suivre le guide de style de votre équipe. La détection automatique des types évite que les booléens, entiers et valeurs null soient entourés de guillemets.