JSONマージパッチ
RFC 7396で定義されているJSONマージパッチを作成または適用できます。作成モードでは、変更前と変更後のドキュメントを比較して、両者の間の最小のマージパッチを取得します。適用モードでは、パッチをドキュメントにマージします。nullはキーを削除し、オブジェクトは再帰的にマージされます。
よくある質問
JSONマージパッチとは?
RFC 7396で定義されているマージパッチは、変更内容をそのまま表すような形式のJSONドキュメントです。値を設定または置換するキーが含まれ、nullに設定されたキーは削除され、ネストされたオブジェクトはマージされます。APIでは、メディアタイプapplication/merge-patch+jsonを指定して受け付けます。
JSONパッチとの違いは何ですか?
JSONパッチ(RFC 6902)は、パス付きの操作リストです。マージパッチは読み書きがより簡単ですが、値をnullに設定できず、配列全体を置き換えるため、個々の項目を変更できません。
作成モードで対象が拒否されるのはなぜですか?
マージパッチではnullがキーの削除を意味するため、オブジェクト内のキーをnullに設定する対象は表現できません。メッセージにパスが表示されます。このような変更にはJSONパッチを使用してください。
配列はどのように扱われますか?
配列の項目ごとのマージは行われません。配列が異なる場合、パッチには新しい配列全体が含まれ、適用すると古い配列全体が置き換えられます。
パッチがオブジェクトではない場合はどうなりますか?
RFC 7396に従い、配列や文字列など、オブジェクトではないパッチはドキュメント全体を置き換えます。
空のパッチは何を意味しますか?
作成モードでは、{}は2つのドキュメントが同じであることを意味します。JSONオブジェクトに{}を適用しても、内容は変わりません。