Partilhar via


IObjectAdapter Interface

Definição

Define as operações que podem ser executadas em um documento de patch JSON.

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

Métodos

Add(Operation, Object)

Usando a operação "add", um novo valor é inserido na raiz do documento de destino, na matriz de destino no índice válido especificado ou em um objeto de destino no local especificado.

Ao adicionar a matrizes, o índice especificado NÃO DEVE ser maior que o número de elementos na matriz. Para acrescentar o valor à matriz, o índice do caractere "-" é usado (consulte [RFC6901]).

Ao adicionar a um objeto, se um membro do objeto ainda não existir, um novo membro será adicionado ao objeto no local especificado ou, se um membro do objeto existir, o valor desse membro será substituído.

O objeto de operação DEVE conter um membro "value" cujo conteúdo especifica o valor a ser adicionado.

Por exemplo:

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

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

Copy(Operation, Object)

Usando a operação de "cópia", um valor é copiado de um local especificado para o local de destino.

O objeto de operação DEVE conter um membro "from", que faz referência ao local no documento de destino do qual copiar o valor.

O local "from" DEVE existir para que a operação seja bem-sucedida.

Por exemplo:

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

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

Move(Operation, Object)

Usando a operação "mover", o valor em um local especificado é removido e adicionado ao local de destino.

O objeto de operação DEVE conter um membro "from", que faz referência ao local no documento de destino do qual mover o valor.

O local "from" DEVE existir para que a operação seja bem-sucedida.

Por exemplo:

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

Um local não pode ser movido para um de seus filhos.

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

Remove(Operation, Object)

Usando a operação "remover", o valor no local de destino é removido.

O local de destino DEVE existir para que a operação seja bem-sucedida.

Por exemplo:

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

Se você remover um elemento de uma matriz, todos os elementos acima do índice especificado serão deslocados uma posição para a esquerda.

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

Replace(Operation, Object)

Usando a operação "substituir", o valor no local de destino é substituído por um novo valor. O objeto de operação DEVE conter um membro "value" que especifica o valor de substituição.

O local de destino DEVE existir para que a operação seja bem-sucedida.

Por exemplo:

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

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

Aplica-se a