1. Introduction

1. Introduction

Cette spécification définit le format de document JSON merge patch (correctif de fusion JSON), les règles de traitement et l'identifiant de type de média MIME associé. Le format de correctif de fusion est principalement destiné à être utilisé avec la méthode HTTP PATCH [RFC5789] comme moyen de décrire un ensemble de modifications du contenu d'une ressource cible.

Un document de correctif de fusion JSON décrit les modifications à apporter à un document JSON cible en utilisant une syntaxe qui imite étroitement le document en cours de modification. Les destinataires d'un document de correctif de fusion déterminent l'ensemble exact des modifications demandées en comparant le contenu du correctif fourni avec le contenu actuel du document cible. Si le correctif de fusion fourni contient des membres qui n'apparaissent pas dans la cible, ces membres sont ajoutés. Si la cible contient le membre, la valeur est remplacée. Les valeurs null dans le correctif de fusion ont une signification spéciale pour indiquer la suppression des valeurs existantes dans la cible.

Par exemple, étant donné le document JSON original suivant:

{
  "a": "b",
  "c": {
    "d": "e",
    "f": "g"
  }
}

La modification de la valeur de "a" et la suppression de "f" peuvent être réalisées en envoyant:

PATCH /target HTTP/1.1
Host: example.org
Content-Type: application/merge-patch+json

{
  "a":"z",
  "c": {
    "f": null
  }
}

Lorsqu'il est appliqué à la ressource cible, la valeur du membre "a" est remplacée par "z" et "f" est supprimé, laissant le contenu restant intact.

Cette conception signifie que les documents de correctif de fusion conviennent pour décrire les modifications apportées aux documents JSON qui utilisent principalement des objets pour leur structure et n'utilisent pas de valeurs null explicites. Le format de correctif de fusion n'est pas approprié pour toutes les syntaxes JSON.