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