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, vous pouvez faire un aller-retour complet d'un fichier (YAML → Properties → YAML) et retrouver un résultat équivalent.
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
Les commentaires peuvent être préservés lors de la conversion lorsque l'option est activée, ce qui compte pour les fichiers de configuration documentés. Les tableaux peuvent être générés sous forme de listes à tirets YAML ou de properties indexées (name[0], name[1]). L'indentation ajustable et la mise entre guillemets des chaînes (auto, toujours, jamais) vous permettent de respecter la charte de style de votre équipe. La détection automatique des types empêche que les valeurs booléennes, entières et nulles soient entourées de guillemets.