model zawartości JSON

Translation not up to date

The translation of this page does not represent the latest version. For the latest updates, see the English version of the documentation.

Go back to the English version of the documentation

model zawartości JSON

Last updated: 25 sie 2023

model zawartości JSON

Model treści JSON jest używany do uzyskiwania dostępu do treści zapisanej w formacie JSON. Udostępnia on podstawowy interfejs API umożliwiający dzwonicom wyodrębnianie wartości przy założeniu, że wiedzą, które wartości mają być dostępne.

Tabela 1. Metody dla modelu treści JSON
Metoda	Typy zwracanych wartości	Opis
`getJSONAsString()`	`String`	Zwraca zawartość JSON jako łańcuch.
`getObjectAt(<List of cbjecta> path, JSONArtifact artifact) throws Exception`	`Object`	Zwraca obiekt wskazany przez określoną ścieżkę. Podany artefakt główny może mieć wartość NULL, w którym to przypadku używany jest element główny treści. Zwracana wartość może być literałem łańcuchowym, liczbą całkowitą, rzeczywistą lub boolowskim lub artefaktem JSON (obiektem JSON lub tablicą JSON).
`getChildValuesAt(<List of object> path, JSONArtifact artifact) throws Exception`	`Hash table (key:object, value:object>`	Zwraca wartości podrzędne określonej ścieżki, jeśli ścieżka prowadzi do obiektu JSON, albo null w przeciwnym wypadku. Klucze w tabeli są łańcuchami, podczas gdy powiązana wartość może być literałem łańcuchowym, liczbą całkowitą, rzeczywistą lub boolowskim, lub artefaktem JSON (obiektem JSON albo tablicą JSON).
`getChildrenAt(<List of object> path path, JSONArtifact artifact) throws Exception`	`List of objects`	Zwraca listę obiektów z określonej ścieżki, jeśli ścieżka prowadzi do tablicy JSON, albo null w przeciwnym wypadku. Zwracane wartości mogą być literałem łańcuchowym, liczbą całkowitą, rzeczywistą lub boolowskim lub artefaktem JSON (obiektem JSON lub tablicą JSON).
`reset()`	`void`	Opróżnia wewnętrzną pamięć związaną z tym modelem zawartości (na przykład zbuforowany obiekt DOM).

Przykładowy skrypt

Jeśli wyjściowy węzeł programu budującego tworzy dane wyjściowe na podstawie formatu JSON, można użyć następujących informacji, aby uzyskać dostęp do informacji na temat zestawu książek:

results = []
outputbuilder.run(results)
output = results[0]
cm = output.getContentModel("jsonContent")

bookTitle = cm.getObjectAt(["books", "ISIN123456", "title"], None)

# Alternatively, get the book object and use it as the root
# for subsequent entries
book = cm.getObjectAt(["books", "ISIN123456"], None)
bookTitle = cm.getObjectAt(["title"], book)

# Get all child values for aspecific book
bookInfo = cm.getChildValuesAt(["books", "ISIN123456"], None)

# Get the third book entry. Assumes the top-level "books" value
# contains a JSON array which can be indexed
bookInfo = cm.getObjectAt(["books", 2], None)

# Get a list of all child entries
allBooks = cm.getChildrenAt(["books"], None)