Altova XMLSpy 2024 Enterprise Edition

JSON, JSON-Schema

Zur Startseite Zurück Nach oben Weiter

JSON (JavaScript Object Notation) ist ein kompaktes Format für die Speicherung und den Austausch von Daten, für das die JavaScript-Syntax verwendet wird. Wie auch das XML-Format ist JSON ein vom Menschen lesbares reines Textformat. Da JSON-Text von jeder Programmiersprache gelesen werden kann, wird es häufig als Format für den Datenaustausch im Internet verwendet.

 

XMLSpy bietet als IDE Unterstützung für die Bearbeitung und Validierung von JSON-Datendokumenten (Instanzdokumente) und die Erstellung von syntaktisch und semantisch korrekten JSON-Schema-Dokumenten.

 

XMLSpy bietet außerdem auch Unterstützung für Avro und Avro-Schema.

 

JSON5

JSON5 bildet eine Erweiterung zu JSON, die zusätzlich über einige ECMAScript 5-Erweiterungen verfügt (Nähere Informationen dazu siehe json5.org). JSON5 ist eine streng eingegrenzte Untermenge von JavaScript, enthält zusätzlich zu den vorhandenen JSON-Typen keine neuen Datentypen und lässt sich mit jedem bestehenden JSON-Content verwenden.

 

Alle XMLSpy-Funktionen, die für JSON-Instanzdokumente zur Verfügung stehen, stehen auch für JSON5-Instanzdokumente zur Verfügung. Beachten Sie jedoch die folgenden wichtigen Unterschiede zwischen JSON5 und JSON hinsichtlich der Art, wie XMLSpy die beiden Formate behandelt:

 

JSON5 ist kein offizieller Nachfolger von JSON. Es wird daher eine eigene Dateierweiterung dafür verwendet: json5.

XMLSpy erkennt Dateien mit der Dateierweiterung .json standardmäßig als JSON-Instanzdokumente und Dateien mit der Erweiterung .json5 als JSON5-Instanzdokumente.

JSON5-Instanzdokumente können anhand von JSON-Schemas validiert werden. JSON-Instanzdokumente, die Avro-Instanzen repräsentieren können, können sowohl anhand von JSON-Schemas (JSON-Instanzen) als auch anhand von Avro-Schemas validiert werden. Näheres zu diesem Thema finden Sie im Abschnitt Validieren von JSON-Dokumenten.

 

Mit dem Begriff JSON-Instanzen werden in dieser Dokumentation, falls nicht anders angegeben, sowohl JSON- als auch JSON5-Instanzdokumente bezeichnet. Siehe auch Abschnitt Unterschiede zwischen JSON5 und JSON.

 

JSON und JSON-Schema in XMLSpy

Beide Dokumenttypen - JSON-Instanz und JSON-Schema - sind im JSON-Format verfasst und müssen den JSON-Regeln für Wohlgeformtheit und Gültigkeit entsprechen. Beide Dokumenttypen (Instanz und Schema) haben normalerweise die Dateierweiterung .json. JSON-Instanzen können in der Text- und der Grid-Ansicht bearbeitet werden und ein JSON-Schema-Dokument kann in diesen beiden Ansichten sowie in der JSON-Schema-Ansicht, einem grafischen Schema-Editor, bearbeitet werden.

 

XMLSpy bietet für das Arbeiten mit JSON-Instanz- und JSON-Schema-Dokumenten die folgenden Funktionalitäten:

 

In der Textansicht Syntaxfärbung und Syntaxüberprüfung; Autokomplettierung in JSON-Schemas und in Instanzdokumenten, wenn diese mit einem Schema verknüpft sind, Klappleisten und Strukturmarkierungen. All diese Hilfsmittel vereinfachen die Bearbeitung gültiger JSON-Instanzen und JSON-Schema-Dokumente. in der Textansicht können Instanz- und Schema-Dokumente validiert werden.

eine Strukturansicht in Tabellenform in der Grid-Ansicht, mit der die Dokumentenstruktur besser visualisiert werden kann. Sie können die Bearbeitungen direkt in der Grid-Ansicht vornehmen und während der Bearbeitung je nach Bedarf zwischen Text- und Grid-Ansicht hin- und herwechseln. Auch in der Grid-Ansicht können Instanz- und Schema-Dokumente validiert werden.

Validierung von JSON-Instanzdokumenten in der Textansicht und der Grid-Ansicht. Die Validierung wird anhand eines im Info-Fenster zugewiesenen JSON-Schemas durchgeführt.

In der JSON-Schema-Ansicht werden JSON-Schemas in einem grafischen Layout angezeigt. Dadurch können Sie zur schnellen Erstellung von JSON-Schemas (neben Texteingaben) auch Drag-and-Drop verwenden. Die Eingabehilfen in der Ansicht stellen Bearbeitungshilfen zur Verfügung. Zusätzlich dazu wird das Schema ständig auf Gültigkeit überprüft und Fehler werden markiert.

 

 

JSON-Instanzen: Öffnen vorhandener Instanzdokumente und Erstellen neuer Instanzdokumente

 

Die Standardansicht (Text- oder Grid-Ansicht), in der JSON/JSON5-Instanzdokumente geöffnet werden sollen, kann im Abschnitt Optionen | Dateiarten eingestellt werden. Vorhandene JSON/JSON5-Dokumente werden in der von Ihnen ausgewählten Standardansicht geöffnet. Sie können jederzeit zwischen Text- und Grid-Ansicht wechseln.

Um ein neues JSON- oder JSON5-Instanzdokument zu erstellen, klicken Sie auf Datei | Neu und wählen Sie json: JavaScript Object Notation bzw. json5: JSON with ECMAScript 5 extensions aus. Sie werden gefragt, ob Sie optional eine JSON- oder (für JSON, nicht aber JSON5) eineAvro-Schema-Datei für die neue Instanzdatei auswählen möchten. Wenn Sie ein Schema zuweisen, erfolgt dies im Info-Fenster. Das neue Instanzdokument wird, abhängig von den Einstellungen im Abschnitt Optionen | Dateiarten, in der Text- oder Grid-Ansicht geöffnet.

 

 

JSON-Schemas: Öffnen vorhandener Schemas und Erstellen neuer Schemas

 

Ein vorhandenes JSON-Schema-Dokument wird in der JSON-Schema-Ansicht geöffnet. Sie können jederzeit in die Text- oder Grid-Ansicht wechseln.

Um ein neues JSON-Schemadokument zu erstellen, klicken Sie auf Datei | Neu und wählen Sie json: JSON Schema aus. Das neue JSON-Schema-Dokument wird in der JSON-Schema-Ansicht geöffnet, wobei am Anfang des Dokuments das Schlüsselwort \$schema zu sehen ist. Sie können jederzeit in die Text- oder Grid-Ansicht wechseln.

 

Alle diese Ansichten (Text, Grid und JSON-Schema) sind in den Unterabschnitten dieses Abschnitts beschrieben.

 

In diesem Abschnitt

Dieser Abschnitt ist in die folgenden Kapitel gegliedert:

 

JSON-Daten: Enthält eine Erläuterung der Grundlagen von JSON-Dokumenten.

JSON-Schema: Enthält eine Beschreibung von JSON-Schemas und deren Funktionsweise.

JSON Lines und JSON-Kommentare: Enthält Informationen über zwei weitere von XMLSpy unterstützte JSON-Spezifikationen.

JSON-Dokumente in der Textansicht: Hier wird beschrieben, wie Sie mit JSON-relevanten Funktionen in der Textansicht arbeiten.

JSON-Dokumente in der Grid-Ansicht: Hier wird beschrieben, wie Sie JSON-Dokumente in der Grid-Ansicht bearbeiten.

JSON-Schema-Ansicht: Beschreibt die JSON-Schemabearbeitungsfunktionen der Ansicht und wie Sie diese zur Erstellung Ihrer JSON-Projekte verwenden.

Validieren von JSON-Daten/-Dokumenten: Hier wird beschrieben, wie Sie einem JSON-Dokument ein JSON-Schema zuweisen und JSON-Dokumente validieren.

Einfügen von JSON-Fragmenten: Hier wird beschrieben, wie Sie JSON-Textfragmente aus externen Quelldokumenten schnell in Ihr JSON-Dokument einfügen.

JSON-Transformationen mit XSLT/XQuery: Hier wird beschrieben, wie JSON-Dokumente mit Hilfe von XPath/XQuery 3.1 abgefragt werden können.

XQuery-Ausdrücke für JSON: Hier finden Sie eine allgemeine Einführung in die Verwendung von XQuery mit JSON-Dokumenten.

Generieren eines JSON-Schemas anhand einer JSON-Instanz: Hier werden die Funktionen zum Generieren eines Schemas anhand eines Instanzdokuments beschrieben.

Generieren einer JSON-Instanz anhand eines JSON-Schemas: Hier wird beschrieben, wie Sie anhand eines Schemas eine Instanz generieren.

Konvertieren zwischen JSON und XML: Hier wird beschrieben, wie Sie in XMLSpy zwischen JSON und XML konvertieren.

 

© 2017-2023 Altova GmbH