IObjectAdapterWithTest Interface

À l’aide de l’opération « ajouter », une nouvelle valeur est insérée à la racine du document cible, dans le tableau cible à l’index valide spécifié ou dans un objet cible à l’emplacement spécifié.

Lors de l’ajout à des tableaux, l’index spécifié NE DOIT PAS être supérieur au nombre d’éléments dans le tableau. Pour ajouter la valeur au tableau, l’index du caractère « - » est utilisé (voir [RFC6901]).

Lors de l’ajout à un objet, si un membre d’objet n’existe pas encore, un nouveau membre est ajouté à l’objet à l’emplacement spécifié ou, si un membre d’objet existe, la valeur de ce membre est remplacée.

L’objet d’opération DOIT contenir un membre « value » dont le contenu spécifie la valeur à ajouter.

Par exemple :

{ « op »: « add », « path »: « /a/b/c », « value »: [ « foo », « bar » ] }

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-4

À l’aide de l’opération « copier », une valeur est copiée à partir d’un emplacement spécifié vers l’emplacement cible.

L’objet d’opération DOIT contenir un membre « de », qui fait référence à l’emplacement dans le document cible à partir duquel copier la valeur.

L’emplacement « de » doit exister pour que l’opération réussisse.

Par exemple :

{ « op »: « copy », « from »: « /a/b/c », « path »: « /a/b/e » }

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-7

À l’aide de l’opération « déplacement », la valeur à un emplacement spécifié est supprimée et ajoutée à l’emplacement cible.

L’objet d’opération DOIT contenir un membre « from », qui fait référence à l’emplacement dans le document cible à partir duquel déplacer la valeur.

L’emplacement « de » doit exister pour que l’opération réussisse.

Par exemple :

{ « op »: « move », « from »: « /a/b/c », « path »: « /a/b/d » }

Un emplacement ne peut pas être déplacé dans l’un de ses enfants.

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-6

À l’aide de l’opération « remove », la valeur à l’emplacement cible est supprimée.

L’emplacement cible DOIT exister pour que l’opération réussisse.

Par exemple :

{ « op »: « remove », « path »: « /a/b/c » }

Si vous supprimez un élément d’un tableau, tous les éléments au-dessus de l’index spécifié sont déplacés d’une position vers la gauche.

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-6

À l’aide de l’opération « remplacer », la valeur à l’emplacement cible est remplacée par une nouvelle valeur. L’objet d’opération DOIT contenir un membre « value » qui spécifie la valeur de remplacement.

L’emplacement cible DOIT exister pour que l’opération réussisse.

Par exemple :

{ « op »: « replace », « path »: « /a/b/c », « value »: 42 }

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-6

À l’aide de l’opération « test », une valeur à l’emplacement cible est comparée pour l’égalité à une valeur spécifiée.

L’objet d’opération DOIT contenir un membre « value » qui spécifie la valeur à comparer à la valeur de l’emplacement cible.

L’emplacement cible DOIT être égal à la valeur « value » pour que l’opération soit considérée comme réussie.

Par exemple : { « op »: « test », « path »: « /a/b/c », « value »: « foo » }

Voir RFC 6902 https://tools.ietf.org/html/rfc6902#page-7