Condividi tramite


IObjectAdapter Interfaccia

Definizione

Definisce le operazioni che è possibile eseguire su un documento di patch JSON.

public interface class IObjectAdapter
public interface IObjectAdapter
type IObjectAdapter = interface
Public Interface IObjectAdapter
Derivato

Metodi

Add(Operation, Object)

L'utilizzo dell'operazione "add" consente di inserire un nuovo valore nella radice del documento di destinazione, nella matrice di destinazione in corrispondenza dell'indice valido specificato o in un oggetto di destinazione nella posizione specificata.

Quando si aggiunge a matrici, l'indice specificato NON DEVE essere maggiore del numero di elementi nella matrice. Per aggiungere il valore alla matrice, viene usato l'indice del carattere "-" (vedere [RFC6901]).

Quando si aggiunge a un oggetto, se un membro dell'oggetto non esiste già, viene aggiunto un nuovo membro all'oggetto nella posizione specificata o se esiste un membro oggetto, il valore del membro viene sostituito.

L'oggetto operazione DEVE contenere un membro "valore" il cui contenuto specifica il valore da aggiungere.

Ad esempio:

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

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

Copy(Operation, Object)

Usando l'operazione di copia, un valore viene copiato da una posizione specificata al percorso di destinazione.

L'oggetto operazione DEVE contenere un membro "from", che fa riferimento alla posizione nel documento di destinazione da cui copiare il valore.

Il percorso "from" deve esistere affinché l'operazione venga completata correttamente.

Ad esempio:

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

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

Move(Operation, Object)

Usando l'operazione "move" il valore in una posizione specificata viene rimosso e aggiunto alla posizione di destinazione.

L'oggetto operazione DEVE contenere un membro "from", che fa riferimento alla posizione nel documento di destinazione da cui spostare il valore.

Il percorso "from" deve esistere affinché l'operazione venga completata correttamente.

Ad esempio:

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

Non è possibile spostare una posizione in uno dei relativi elementi figlio.

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

Remove(Operation, Object)

L'utilizzo dell'operazione "remove" comporta la rimozione del valore nella posizione di destinazione.

Il percorso di destinazione DEVE esistere affinché l'operazione venga completata correttamente.

Ad esempio:

{ "op": "remove", "path": "/a/b/c" }

Se si rimuove un elemento da una matrice, tutti gli elementi sopra l'indice specificato vengono spostati una posizione a sinistra.

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

Replace(Operation, Object)

Usando l'operazione "replace" il valore nella posizione di destinazione viene sostituito con un nuovo valore. L'oggetto operazione DEVE contenere un membro "value" che specifica il valore di sostituzione.

Il percorso di destinazione DEVE esistere affinché l'operazione venga completata correttamente.

Ad esempio:

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

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

Si applica a