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”成员,该成员引用目标文档中要从其复制值的位置。

必须存在“发件人”位置才能使操作成功。

例如:

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

请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-7

Move(Operation, Object)

使用“移动”操作删除指定位置的值并将其添加到目标位置。

操作对象必须包含一个“from”成员,该成员引用要从中移动值的目标文档中的位置。

必须存在“发件人”位置才能使操作成功。

例如:

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

无法将某个位置移到其某个子级中。

请参阅 RFC 6902 https://tools.ietf.org/html/rfc6902#page-6

Remove(Operation, Object)

使用“删除”操作删除目标位置的值。

必须存在目标位置才能使操作成功。

例如:

{ “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

适用于