Udostępnij za pośrednictwem


IObjectAdapter Interfejs

Definicja

Definiuje operacje, które można wykonać w dokumencie poprawki JSON.

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

Metody

Add(Operation, Object)

Za pomocą operacji "dodaj" nowa wartość jest wstawiana do katalogu głównego dokumentu docelowego, do tablicy docelowej w określonym prawidłowym indeksie lub do obiektu docelowego w określonej lokalizacji.

Podczas dodawania do tablic określony indeks NIE MOŻE być większy niż liczba elementów w tablicy. Aby dołączyć wartość do tablicy, używany jest indeks znaku "-" (zobacz [RFC6901]).

Podczas dodawania do obiektu, jeśli element członkowski obiektu jeszcze nie istnieje, nowy element członkowski zostanie dodany do obiektu w określonej lokalizacji lub jeśli element członkowski obiektu istnieje, wartość tego elementu członkowskiego zostanie zamieniona.

Obiekt operacji MUSI zawierać element członkowski "value", którego zawartość określa wartość do dodania.

Przykład:

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

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

Copy(Operation, Object)

Za pomocą operacji "copy" wartość jest kopiowana z określonej lokalizacji do lokalizacji docelowej.

Obiekt operacji MUSI zawierać element członkowski "from", który odwołuje się do lokalizacji w dokumencie docelowym, aby skopiować wartość z.

Lokalizacja "from" MUSI istnieć, aby operacja zakończyła się pomyślnie.

Przykład:

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

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

Move(Operation, Object)

Za pomocą operacji "move" wartość w określonej lokalizacji jest usuwana i dodawana do lokalizacji docelowej.

Obiekt operacji MUSI zawierać element członkowski "from", który odwołuje się do lokalizacji w dokumencie docelowym, aby przenieść wartość z.

Lokalizacja "from" MUSI istnieć, aby operacja zakończyła się pomyślnie.

Przykład:

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

Nie można przenieść lokalizacji do jednego z jej elementów podrzędnych.

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

Remove(Operation, Object)

Za pomocą operacji "remove" wartość w lokalizacji docelowej jest usuwana.

Lokalizacja docelowa MUSI istnieć, aby operacja zakończyła się pomyślnie.

Przykład:

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

Jeśli usuniesz element z tablicy, wszystkie elementy powyżej określonego indeksu zostaną przesunięte w jedną pozycję z lewej strony.

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

Replace(Operation, Object)

Za pomocą operacji "replace" wartość w lokalizacji docelowej jest zastępowana nową wartością. Obiekt operacji MUSI zawierać element członkowski "value", który określa wartość zastępczą.

Lokalizacja docelowa MUSI istnieć, aby operacja zakończyła się pomyślnie.

Przykład:

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

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

Dotyczy