Merge patch JSON
Create o applicate una Merge Patch JSON secondo la definizione in RFC 7396. In modalità di creazione, confrontate un documento originale con uno di destinazione per ottenere la merge patch più piccola che li rende uguali. In modalità di applicazione, unite una patch a un documento: null rimuove una chiave e gli oggetti vengono uniti in modo ricorsivo.
Domande frequenti
Che cos'è una Merge Patch JSON?
Una merge patch, definita in RFC 7396, è un documento JSON che rappresenta le modifiche che descrive. Le chiavi con valori impostati o sostituiti vengono aggiornate, quelle impostate a null vengono rimosse e gli oggetti annidati vengono uniti. Le API la accettano con il tipo di media application/merge-patch+json.
In cosa differisce dalla patch JSON?
La patch JSON (RFC 6902) è un elenco di operazioni con percorsi. Una merge patch è più semplice da leggere e scrivere, ma non consente di impostare un valore a null e sostituisce sempre gli array interi invece di modificare singoli elementi.
Perché la modalità di creazione rifiuta la destinazione?
In una merge patch, null significa rimuovere la chiave, quindi non è possibile esprimere una destinazione che imposta a null una chiave all'interno di un oggetto. Il messaggio indica il percorso. Per queste modifiche, usate la patch JSON.
Come vengono gestiti gli array?
Gli elementi degli array non vengono mai uniti singolarmente. Se un array è diverso, la patch contiene l'intero nuovo array e, una volta applicata, sostituisce completamente quello precedente.
Cosa succede se la patch non è un oggetto?
Secondo RFC 7396, una patch che non è un oggetto, come un array o una stringa, sostituisce l'intero documento.
Cosa significa una patch vuota?
In modalità di creazione, {} significa che i due documenti sono uguali. Applicare {} a un oggetto JSON non lo modifica.