JSONObject (Objekt)

Name

JSONObject - http://www.json.org/

Beschreibung

Ein JSONObject kann über String.toJson erzeugt werden um JSON-Daten die als Zeichenkette vorliegen verarbeiten zu können. Über die normale Objekt-Notation von SPML kann dann auf die Daten des JSONObject zugegriffen werden.

<sp:set name="jsontxt">{
   "a" : null,
   "b" : 1,
   "c" : 1.4,
   "d" : "abc",
   "e" : [1,2,3]
}</sp:set>
<sp:set name="json" object="jsontxt.toJson"/>

<sp:print name="json.b"/><br>
<sp:print name="json.e[1]"/>

Das JSONObject stellt Methoden bereit dessen Rückgabewerte mit sp:loop verwendbar sind

<sp:set name="jsontxt">{
   "a" : null,
   "b" : 1,
   "c" : 1.4,
   "d" : "abc",
   "e" : [1,2,3]
}</sp:set>
<sp:set name="json" object="jsontxt.toJson"/>
<sp:loop collection="json.getValues()" item="it">
  <sp:print name="it"/>
</sp:loop>

Methoden

Methode	Rückgabewert	Beschreibung	ab IES Version
get(String name)	Objekt	Liefert Wert der unter name abgelegt ist.	2.9
length()	Number	Liefert die Anzahl der Namen/Werte Paare in dem JSON-Objektes.	2.9
getNames()	Collection <String>	Liefert die Liste aller Namen des JSON-Objektes.	2.9
entrySet()	Collection <MapEntry>	Liefert die Liste aller Namen/Werte Paare des JSON-Objektes.	2.9
getValues()	Collection	Liefert die Liste aller Werte des JSON-Objektes.	2.9
toString()	String	Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.	2.9
toString(Number indentFactor)	String	Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.	2.9
toString(Number indentFactor, Number indent)	String	Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.	2.9
toString(Number indentFactor, Number indent, String indentChar)	String	Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.	2.9
toPhpArray()	String	Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.	2.9
toPhpArray(Number indentFactor)	String	Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.	2.9
toPhpArray(Number indentFactor, Number indent)	String	Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.	2.9
toPhpArray(Number indentFactor, Number indent, String indentChar)	String	Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.	2.9
locale(String locale)	Object	Liefert bei einer mehrsprachigen JSON-Struktur die Daten der entsprechenden Sprache.	2.13
locale(String locale, Boolean lookup)	Object	Liefert bei einer mehrsprachigen JSON-Struktur die Daten der entsprechenden Sprache.	2.13

Methoden

Methode	Rückgabewert	Beschreibung	ab IES Version
locale(String locale)	Object	Liefert bei einem Mehrsprachigem Feld den Text mit der angegebenen Sprache	2.13
locale(String locale, Boolean lookup)	Object	Liefert bei einem Mehrsprachigem Feld den Text mit der angegebenen Sprache	2.13

Object get(String name)

Liefert Wert der unter name abgelegt ist.

Rückgabewert

Object

Wert der unter name abgelegt ist.

Number length()

Liefert die Anzahl der Element in dem Array.

Rückgabewert

Number

Anzahl der Element in dem Array.

Collection <String> getNames()

Liefert die Liste aller Namen des JSON-Objektes.

Rückgabewert

Collection <String>

Liste aller Namen des JSON-Objektes.

Collection <MapEntry> entrySet()

Liefert die Liste aller Namen/Werte Paare des JSON-Objektes.

Rückgabewert

Collection <MapEntry>

Liste aller Namen/Werte Paare des JSON-Objektes.

Collection getValues()

Liefert die Liste aller Werte des JSON-Objektes.

Rückgabewert

Collection

Liste aller Werte des JSON-Objektes.

String toString(Number indentFactor, Number indent, String indentChar)

Erzeugt aus den Daten des JSONObject einen String, der mit sp:print ausgegeben werden kann.

Parameter

Number indentFactor

Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).

Number indent

Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).

String indentChar

Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').

Rückgabewert

String

JSON als String.

String toPhpArray(Number indentFactor, Number indent, String indentChar)

Erzeugt aus den Daten des JSONObject einen String in PHP-Array-Notation, der mit sp:print ausgegeben werden kann.

Parameter

Number indentFactor

Anzahl der Einrückungen pro Ebene. Optional (Default-Wert: 0).

Number indent

Initiale Anzahl der Einrückungs-Zeichen. Optional (Default-Wert: 0).

String indentChar

Zeichen, das als Einrückungszeichen verwendet werden soll. Optional (Default-Wert: ' ').

Rückgabewert

String

PHPArray als String.

Object locale(String locale, Boolean lookup)

Liefert bei einer mehrsprachigen JSON-Struktur die Daten der entsprechenden Sprache. Mehrsprachige JSON-Strukturen sind so definiert, das die Keys das Locale definieren

{
   myMultilingualData: {
      "de" : {
         ...
      },
      "en" : {
         ...
      }
   }
}

Es wird ein Lookup angewendet (wenn nicht deaktiviert). der zunächst nach z.B. 'de_DE' sucht, wenn für das Locale kein Wert definiert ist, dann wird nach 'de' gesucht, wenn dann auch noch nichts gefunden wird, dann wir nach 'default' gesucht. Beispiel:

<sp:print name="myMultilingualData.locale('de_DE')"/>

Parameter

String locale

Locale das verwendet werden soll.

Boolean lookup (optional, default ist true)

Gibt an ob ein Lookup für das Locale angewendet werden soll.

Rückgabewert

Object

Wert der angegebenen Sprache oder null.