JSON-samenvoegpatch
Maak of pas een JSON-samenvoegpatch toe zoals gedefinieerd in RFC 7396. Vergelijk in de maakmodus een origineel en een doeldocument om de kleinst mogelijke samenvoegpatch te krijgen. Voeg in de toepasmodus een patch samen met een document; null verwijdert een sleutel en objecten worden recursief samengevoegd.
Veelgestelde vragen
Wat is een JSON-samenvoegpatch?
Een samenvoegpatch, gedefinieerd in RFC 7396, is een JSON-document dat eruitziet als de wijzigingen die het beschrijft. Sleutels krijgen een waarde of worden vervangen; sleutels met de waarde null worden verwijderd en geneste objecten worden samengevoegd. API's accepteren de patch met het mediatype application/merge-patch+json.
Wat is het verschil met een JSON-patch?
Een JSON-patch (RFC 6902) is een lijst met bewerkingen en paden. Een samenvoegpatch is eenvoudiger te lezen en schrijven, maar kan een waarde niet op null zetten en vervangt altijd volledige arrays in plaats van afzonderlijke items te wijzigen.
Waarom weigert de maakmodus mijn doel?
In een samenvoegpatch betekent null dat de sleutel wordt verwijderd. Daarom kan een doel waarin een sleutel in een object op null wordt gezet niet worden uitgedrukt. Het bericht vermeldt het pad. Gebruik voor zulke wijzigingen een JSON-patch.
Hoe worden arrays afgehandeld?
Arrays worden nooit item voor item samengevoegd. Als een array verschilt, bevat de patch de volledige nieuwe array en vervangt toepassing ervan de oude array volledig.
Wat als de patch geen object is?
Volgens RFC 7396 vervangt een patch die geen object is, zoals een array of tekenreeks, het volledige document.
Wat betekent een lege patch?
In de maakmodus betekent {} dat de twee documenten gelijk zijn. Toepassing van {} op een JSON-object laat het ongewijzigd.