Поделиться через


IObjectAdapter Интерфейс

Определение

Определяет операции, которые могут выполняться с документом исправлений JSON.

public interface class IObjectAdapter
public interface IObjectAdapter
type IObjectAdapter = interface
Public Interface IObjectAdapter
Производный

Методы

Add(Operation, Object)

С помощью операции "добавить" новое значение вставляется в корень целевого документа, в целевой массив по указанному допустимому индексу или в целевой объект в указанном расположении.

При добавлении в массивы указанный индекс НЕ ДОЛЖЕН превышать количество элементов в массиве. Чтобы добавить значение в массив, используется индекс символа "-" (см. [RFC6901]).

Если элемент объекта еще не существует, при добавлении к объекту в указанном расположении добавляется новый элемент или, если элемент объекта существует, значение этого элемента заменяется.

Объект операции ДОЛЖЕН содержать элемент value, содержимое которого указывает добавляемое значение.

Пример:

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

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

Copy(Operation, Object)

С помощью операции копирования значение копируется из указанного расположения в целевое расположение.

Объект операции ДОЛЖЕН содержать элемент from, который ссылается на расположение в целевом документе для копирования значения.

Для успешного выполнения операции должно существовать расположение from.

Пример:

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

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

Move(Operation, Object)

С помощью операции перемещения значение в указанном расположении удаляется и добавляется в целевое расположение.

Объект операции ДОЛЖЕН содержать элемент from, который ссылается на расположение в целевом документе для перемещения значения.

Для успешного выполнения операции должно существовать расположение from.

Пример:

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

Расположение не может быть перемещено в один из его дочерних элементов.

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

Remove(Operation, Object)

С помощью операции remove значение в целевом расположении удаляется.

Целевое расположение ДОЛЖНО существовать для успешного выполнения операции.

Пример:

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

При удалении элемента из массива все элементы выше указанного индекса сдвигаются на одну позицию влево.

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

Replace(Operation, Object)

При использовании операции "заменить" значение в целевом расположении заменяется новым значением. Объект операции ДОЛЖЕН содержать элемент value, указывающий значение замены.

Целевое расположение ДОЛЖНО существовать для успешного выполнения операции.

Пример:

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

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

Применяется к