JSON-Merge-Patch
Erstelle oder wende einen JSON-Merge-Patch gemäß RFC 7396 an. Vergleiche im Erstellungsmodus ein ursprüngliches und ein Zieldokument, um den kleinsten Merge-Patch zu erhalten. Füge im Anwendungsmodus einen Patch mit einem Dokument zusammen. Dabei entfernt null einen Schlüssel und Objekte werden rekursiv zusammengeführt.
Häufig gestellte Fragen
Was ist ein JSON-Merge-Patch?
Ein Merge-Patch gemäß RFC 7396 ist ein JSON-Dokument, das die beschriebenen Änderungen abbildet. Schlüssel mit festgelegten oder ersetzten Werten werden entsprechend gesetzt. Schlüssel mit dem Wert null werden entfernt, und verschachtelte Objekte werden zusammengeführt. APIs akzeptieren ihn mit dem Medientyp application/merge-patch+json.
Worin unterscheidet er sich vom JSON-Patch?
Ein JSON-Patch (RFC 6902) ist eine Liste von Operationen mit Pfaden. Ein Merge-Patch ist einfacher zu lesen und zu schreiben, kann aber einen Wert nicht auf null setzen und ersetzt immer ganze Arrays statt einzelne Elemente zu ändern.
Warum lehnt der Erstellungsmodus mein Ziel ab?
Bei einem Merge-Patch bedeutet null, dass der Schlüssel entfernt wird. Daher lässt sich ein Ziel nicht ausdrücken, bei dem ein Schlüssel innerhalb eines Objekts auf null gesetzt wird. Die Meldung nennt den Pfad. Verwende für solche Änderungen einen JSON-Patch.
Wie werden Arrays behandelt?
Arrays werden nie Element für Element zusammengeführt. Unterscheidet sich ein Array, enthält der Patch das gesamte neue Array. Bei der Anwendung wird das alte Array vollständig ersetzt.
Was ist, wenn der Patch kein Objekt ist?
Gemäß RFC 7396 ersetzt ein Patch, der kein Objekt ist, etwa ein Array oder eine Zeichenfolge, das gesamte Dokument.
Was bedeutet ein leerer Patch?
Im Erstellungsmodus bedeutet {} , dass die beiden Dokumente gleich sind. Wird {} auf ein JSON-Objekt angewendet, bleibt es unverändert.