コンテンツへスキップ

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オブジェクトに{}を適用しても、内容は変わりません。

OneClick Proについて

OneClick Proは、日々の作業に役立つ150以上のウェブツールを集めた無料コレクションです。画像や単位の変換、コードの整形と検証、ドメインやSEOの確認、テキスト、日付、数値の処理などに利用できます。すべてのツールは登録やサブスクリプションなしで使えます。入力した内容は結果の計算にのみ使用され、保存されることはありません。単発の作業に使える便利なツールボックスとして、または毎日使うツールをブックマークしてご活用ください。