JSON zusammenführen

Deep Merge und JSON Merge Patch im Vergleich

Wer Konfigurationen, Übersetzungen oder API-Daten pflegt, muss oft zwei JSON-Dokumente zusammenführen: eine Basis und eine Ergänzung, die einzelne Werte überschreibt. Ein einfaches Überschreiben auf oberster Ebene reicht dafür selten, weil verschachtelte Objekte dann komplett ersetzt würden. Ein Deep Merge geht rekursiv vor: Objekte werden Schlüssel für Schlüssel zusammengeführt, nur einfache Werte aus B ersetzen die aus A. So können Sie JSON-Dateien kombinieren, ohne Einstellungen zu verlieren.

Bei Arrays gibt es keine eindeutig richtige Lösung, deshalb wählen Sie die Strategie selbst: B ersetzt A, Anhängen, Anhängen ohne Duplikate, Zusammenführen nach Position oder nach einem Schlüsselfeld wie id (einfache Werte werden dabei ohne Duplikate angehängt). Das zweite Verfahren ist JSON Merge Patch nach RFC 7386. Es ist als application/merge-patch+json für HTTP-PATCH standardisiert: Objekte werden rekursiv zusammengeführt, null löscht einen Schlüssel, und Arrays werden immer vollständig ersetzt. Dieser JSON Merge ist also vorhersagbar, kann aber einzelne Array-Elemente nicht ändern.

Grenzen: Ändert sich der Typ eines Wertes, etwa von Objekt zu String, gewinnt immer B. Die Reihenfolge der Schlüssel folgt A, neue Schlüssel aus B werden angehängt. Für gezielte Änderungen an Array-Elementen ist JSON Patch anwenden nach RFC 6902 besser geeignet; Unterschiede zwischen Ergebnis und Basis zeigt JSON vergleichen.