Überblick über JSON Befehle

JSON Befehle generieren und analysieren Objekte der Programmiersprache im Format JSON. Das JSON Format ermöglicht insbesondere, über einen Web Browser auf 4D Anwendungen zuzugreifen (Daten und Struktur).

Die Programmiersprache von 4D v14 bietet als neues Haupt-Feature die Unterstützung von strukturierten Objekten, um den Austausch von strukturierten Daten zu erleichtern. Über die Befehle im Kapitel "JSON" kann 4D direkt mit JSON Objekten arbeiten, aber genauso mit "native" Objekten, d.h. mit von JSON inspirierter Struktur, die den Austausch mit vielen anderen Programmiersprachen möglich machen. Weitere Informationen dazu finden Sie im Kapitel Objekte (Sprache).

"JSON oder JavaScript Object Notation ist ein generisches text-basiertes Datenformat, das sich ableitet von der Objektnotation der ECMAScript Sprache" (Quelle: Wikipedia). JSON ist komplett unabhängig von Programmiersprachen, folgt aber vielen Konventionen, die Programmierer von C-basierten Sprachen (C++, JavaScript, Perl, u.v.a.) kennen. Dieses Format eignet sich besonders zum Datenaustausch.

Dieser Abschnitt gibt einen Überblick über die in JSON integrierten Merkmale für Notation. Eine ausführliche Beschreibung dazu finden Sie unter: www.json.org/index.html.

Die Syntax von JSON basiert auf folgenden Grundlagen:

• Daten bestehen aus Name/Wert Paaren
• Daten werden durch Komma getrennt
• Objekte werden durch geschweifte Klammern { } definiert
• Arrays werden durch eckige Klammern [ ] definiert

JSON Daten werden in Paaren Name/Wert oder Schlüssel/Wert ausgedrückt. Ein solches Paar enthält einen Feldnamen in Anführungszeichen, gefolgt von einem Doppelpunkt, und einen Wert. Zum Beispiel:

"vorName":"Hans"

Zur Info: Dieses Beispiel sieht in JavaScript folgendermaßen aus:

vorName="Hans"

Beachten Sie, dass Eigennamen diakritische Zeichen und Groß-/Kleinschreibung berücksichtigen. Schreiben Sie "VorName" anstelle von "vorname," erhalten Sie ein neues Name/Wert Paar.

JSON unterstützt folgende Wertetypen:

JSON Objekte werden mit Klammern definiert. Sie können eine undefinierte Anzahl von Name/Wert Paaren enthalten, z.B.:

{ "vorName":"Hans" , "nachName":"Dampf" }

JSON Objekte lassen sich in 4D über Variablen und Felder vom Typ Objekt speichern und verwalten (C_OBJECT).

JSON Arrays werden mit Klammern definiert. Jedes Array kann eine undefinierte Anzahl Objekte enthalten:

{
    "Angestellte": [
        { "vorName":"Hans" , "nachName":"Dampf" },
        { "vorName":"Anna" , "nachName":"Schmid" },
        { "vorName":"Peter" , "nachName":"Meier" }
    ]
}

4D Datumsangaben, die von oder in das JSON Format konvertiert werden, berücksichtigen standardmäßig die Zeitzone des konvertierenden Rechners. Dieses Prinzip entspricht der Standardoperation von Java-Script. Zum Beispiel ergibt Konvertieren des Datums !23/08/2013! in Deutschland (GMT+2) als Ergebnis "2013-08-22T22:00:00Z" und umgekehrt. 

Dieses Standardverhalten können Sie mit dem Befehl SET DATABASE PARAMETER ändern, z.B. wenn Sie beim Implementieren von Exportoperationen keine Zeitzonen berücksichtigen wollen. 

Weitere Informationen dazu finden Sie im Abschnitt Konvertieren von Datum in JavaScript.