Arbeiten mit YAML- und Java-Properties-Konfiguration
Was dieser Konverter macht
YAML und Java-.properties-Dateien sind zwei Arten, dieselbe Konfiguration zu schreiben. Properties-Dateien speichern pro Zeile ein flaches Schlüssel=Wert-Paar und deuten die Hierarchie über Punkte an (server.servlet.context-path=/api). YAML drückt dieselbe Hierarchie durch echte Einrückung und Verschachtelung aus. Dieses Tool liest beide Formate, erkennt, welches du eingefügt hast, und schreibt es in das jeweils andere um: Es entfaltet punktierte Schlüssel zu einem verschachtelten Baum oder flacht einen Baum wieder zu punktierten Pfaden ab.
Da die Konvertierung bidirektional ist und auf der erkannten Struktur statt auf einer festen Vorlage beruht, kann eine Datei den Hin-und-zurück-Weg (YAML → Properties → YAML) mit denselben Schlüsseln und Werten durchlaufen. Damit Listen Listen bleiben, wähle unter Array-Format die Option Indiziert ([0]) — beim Standardstil, durch Komma getrennt, kommt eine Liste als ein einzelner Textwert zurück, und #-Zeilen landen oben.
Wann man es einsetzt
Der häufigste Fall ist ein Spring-Boot-Projekt, das zwischen application.properties und application.yml migriert. Teams beginnen meist mit Properties und wechseln zu YAML, sobald die Konfiguration so tief wird, dass punktierte Schlüssel schwer zu lesen sind. Die umgekehrte Richtung ist genauso nützlich, wenn ein Tool oder eine Deployment-Pipeline flache Properties erwartet.
Praktisch ist es auch, um zwei Konfigurationen schnell zu vergleichen, einen Ausschnitt aus der Dokumentation in das Format zu bringen, das dein Projekt tatsächlich verwendet, oder Einrückung und Array-Stil vor dem Commit zu vereinheitlichen.
Beispiel: ein Server-Block
Aus den Properties-Zeilen server.port=8080 und server.servlet.context-path=/api wird ein verschachtelter YAML-Block, in dem server den Eintrag port: 8080 sowie einen Schlüssel servlet mit context-path: /api enthält. Konvertierst du zurück, tauchen die punktierten Schlüssel exakt wieder auf. Zahlen wie 8080 bleiben ohne Anführungszeichen, damit sie ihren Ganzzahltyp behalten und nicht zu Zeichenketten werden.
Formathinweise und Sonderfälle
Ist Kommentare Erhalten aktiviert (Standard), werden Zeilen, die mit # beginnen, an den Anfang des Ergebnisses verschoben; ein Kommentar am Zeilenende bleibt nicht erhalten, und ein Kommentar steht nicht mehr neben dem Schlüssel, den er beschrieb. Von YAML zu Properties wird eine Liste zu einem einzigen, durch Komma getrennten Wert (tools=a,b) oder zu indizierten Zeilen (tools[0]=a, tools[1]=b); von Properties zu YAML werden indizierte Zeilen zu einer YAML-Liste mit Strichen. Einstellbare Einrückung und String-Anführungszeichen (auto, immer, nie) lassen dich den Styleguide deines Teams einhalten. Die automatische Typerkennung verhindert, dass Booleans, Ganzzahlen und null-Werte in Anführungszeichen stehen.