Parche de combinación JSON
Crea o aplica un Merge Patch JSON según la definición de RFC 7396. En el modo de creación, compara un documento original con uno de destino para obtener el parche de combinación más pequeño posible. En el modo de aplicación, combina un parche con un documento; null elimina una clave y los objetos se combinan de forma recursiva.
Preguntas frecuentes
¿Qué es un Merge Patch JSON?
Un merge patch, definido en RFC 7396, es un documento JSON que representa los cambios que describe. Las claves con valores se establecen o reemplazan, las claves con valor null se eliminan y los objetos anidados se combinan. Las API lo aceptan con el tipo de contenido application/merge-patch+json.
¿En qué se diferencia de JSON Patch?
JSON Patch (RFC 6902) es una lista de operaciones con rutas. Un merge patch es más fácil de leer y escribir, pero no permite establecer un valor como null y siempre reemplaza los arreglos enteros en lugar de modificar elementos individuales.
¿Por qué el modo de creación rechaza mi destino?
En un merge patch, null significa que se elimina la clave, por lo que no se puede expresar un destino que establezca en null una clave dentro de un objeto. El mensaje indica la ruta. Para esos cambios, usa JSON Patch.
¿Cómo se gestionan los arreglos?
Los arreglos nunca se combinan elemento por elemento. Si un arreglo es distinto, el parche contiene el arreglo nuevo completo y, al aplicarlo, reemplaza por completo el anterior.
¿Qué ocurre si el parche no es un objeto?
Según RFC 7396, un parche que no sea un objeto, como un arreglo o una cadena, reemplaza el documento entero.
¿Qué significa un parche vacío?
En el modo de creación, {} significa que los dos documentos son iguales. Aplicar {} a un objeto JSON no lo modifica.