Merge Patch JSON
Створіть або застосуйте Merge Patch JSON, визначений у RFC 7396. У режимі створення порівняйте початковий і цільовий документи, щоб отримати найкоротший merge patch між ними. У режимі застосування об'єднайте патч із документом: null видаляє ключ, а об'єкти об'єднуються рекурсивно.
Поширені запитання
Що таке Merge Patch JSON?
Merge patch, визначений у RFC 7396, — це документ JSON, схожий на зміни, які він описує. Ключі з указаними або заміненими значеннями встановлюються, ключі зі значенням null видаляються, а вкладені об'єкти об'єднуються. API приймають його з типом медіаданих application/merge-patch+json.
Чим він відрізняється від JSON Patch?
JSON Patch (RFC 6902) — це список операцій зі шляхами. Merge patch простіше читати й записувати, але він не може встановити значення null і завжди замінює масиви цілком, а не змінює окремі елементи.
Чому режим створення відхиляє цільовий документ?
У merge patch значення null означає видалення ключа, тому неможливо описати цільовий документ, у якому ключу всередині об'єкта присвоєно null. У повідомленні вказано шлях. Для таких змін використовуйте JSON Patch.
Як обробляються масиви?
Масиви ніколи не об'єднуються поелементно. Якщо масив відрізняється, патч містить весь новий масив, а під час застосування повністю замінює старий.
Що буде, якщо патч не є об'єктом?
Згідно з RFC 7396, патч, який не є об'єктом, наприклад масив або рядок, замінює весь документ.
Що означає порожній патч?
У режимі створення {} означає, що документи однакові. Застосування {} до об'єкта JSON не змінює його.