cassia.util

Class JSON.Value

cassia.util.JSON.Value

Enclosing class:

JSON

public static class JSON.Value

JSON.parse(String) returns JSON.Value.

To access the content, use the apply operators:

    val json = JSON.parse(...);
    val x = json("x");
    val y = json("y", "default");     // default
    val z = json(["z1", "z2", "z3"]); // first one

If the key is a number, it is interpreted as a JSON Array (or X10 List) type. If the key is a string, it is interpreted as a JSON Object (or X10 Map) type. See the definition below for details.

Constructor Summary

Constructors

Constructor and Description
JSON.Value(Any value, cassia.util.JSON.Reader p, Int i)
JSON.Value(Any value)

Method Summary

Modifier and Type	Method and Description
<T> JSON.Value	any(Rail<T> s) Get the value associated with the key first matched if any such exists.
List<JSON.Value>	asList()
Map<String,JSON.Value>	asMap()
JSON.Value	clone()
Boolean	equals(Any that) Perform a String-vs-String equality test.
<T> JSON.Value	get(T s) Get the value associated with the key if exists.
<T> JSON.Value	get(Rail<T> s) Get the final value associated with all the keys in the list.
protected String	getExInfo() Get an error message with the JSON text around.
<T> JSON.Value	getOrElse(T s, String orElse) Get the value associated with the key if exists; Otherwise return JSON.parse(orElse).
<T> Boolean	has(T s) Test if it has the key s.
Boolean	isList()
Boolean	isMap()
Boolean	isNull()
<T> JSON.Value	operator()(T key) Get the value associated with the key if exists.
<T> JSON.Value	operator()(Rail<T> keys) Get the value associated with the key first matched if any such exists.
<T> JSON.Value	operator()(T key, String orElse) Get the value associated with the key if exists; Otherwise returns JSON.parse(orElse).
<T> JSON.Value	operator()=(T key, JSON.Value v)
<T> JSON.Value	operator()=(T key, Any v)
<T> JSON.Value	put(T s, JSON.Value v)
<T> JSON.Value	put(T s, Any v)
void	set(Any v)
Long	size() Get the size of this JSON Array or JSON Object (otherwise return 0).
Boolean	toBoolean()
Double	toDouble()
Int	toInt()
Long	toLong()
String	toString() Cast this JSON.Value to String.

Constructor Detail

JSON.Value

public JSON.Value(Any value,
                  cassia.util.JSON.Reader p,
                  Int i)

JSON.Value

public JSON.Value(Any value)

Method Detail

get

public <T> JSON.Value get(T s)

Get the value associated with the key if exists. The key can be of any type. The key is first casted in toString() and then treated as Long if isList() but as String if isMap().

    JSON: {"one": {"two": {"three": 3}}}
    X10 : json("one")("two")("three").toLong()    // gets 3

Parameters:

s - a key

Returns:

the value

get

public <T> JSON.Value get(Rail<T> s)

Get the final value associated with all the keys in the list.

    JSON: {"one": {"two": {"three": 3}}}
    X10 : json(["one", "two", "three"]).toLong()    // gets 3

Parameters:

s - a key list

Returns:

the value

getOrElse

public <T> JSON.Value getOrElse(T s,
                                String orElse)

Get the value associated with the key if exists; Otherwise return JSON.parse(orElse).

    JSON: {"one": {"two": {"three": 3}}}
    X10 : json("one")("two")("threat", "13").toLong()    // gets 13

Parameters:

s - a key

orElse - a JSON text used if s not found

Returns:

the value

set

public void set(Any v)

put

public <T> JSON.Value put(T s,
                          JSON.Value v)

put

public <T> JSON.Value put(T s,
                          Any v)

has

public <T> Boolean has(T s)

Test if it has the key s.

Parameters:

s - a key

Returns:

any

public <T> JSON.Value any(Rail<T> s)

Get the value associated with the key first matched if any such exists.

    JSON: {"one": 1, "TWO": 2, "THREE": 3}
    X10 : json(["ONE", "TWO", "THREE"]).toLong()    // gets 2

Parameters:

s - a key list

Returns:

the value

size

public Long size()

Get the size of this JSON Array or JSON Object (otherwise return 0).

Returns:

operator()

public <T> JSON.Value operator()(T key)

Get the value associated with the key if exists. The key can be of any type. The key is first casted in toString() and then treated as Long if isList() but as String if isMap().

    JSON: {"one": {"two": {"three": 3}}}
    X10 : json("one")("two")("three").toLong()    // gets 3

Parameters:

key - a key

Returns:

the value

operator()=

public <T> JSON.Value operator()=(T key,
                                  JSON.Value v)

operator()=

public <T> JSON.Value operator()=(T key,
                                  Any v)

operator()

public <T> JSON.Value operator()(T key,
                                 String orElse)

Get the value associated with the key if exists; Otherwise returns JSON.parse(orElse).

    JSON: {"one": {"two": {"three": 3}}}
    X10 : json("one")("two")("threat", "13").toLong()    // gets 13

Parameters:

key - a key

orElse - a JSON text used if s not found

Returns:

the value

operator()

public <T> JSON.Value operator()(Rail<T> keys)

Get the value associated with the key first matched if any such exists.

    JSON: {"one": 1, "TWO": 2, "THREE": 3}
    X10 : json(["ONE", "TWO", "THREE"]).toLong()    // gets 2

Parameters:

keys - a key list

Returns:

the value

isNull

public Boolean isNull()

isMap

public Boolean isMap()

asMap

public Map<String,JSON.Value> asMap()

isList

public Boolean isList()

asList

public List<JSON.Value> asList()

equals

public Boolean equals(Any that)

Perform a String-vs-String equality test. Any argument is casted to String and then compared. This is to avoid the common pitfall: Without overriding equals(), the following

    json("x").equals("x")

results in the unintended JSON.Value-vs-String test, returning always false.

Parameters:

that -

Returns:

getExInfo

protected String getExInfo()

Get an error message with the JSON text around.

Returns:

toString

public String toString()

Cast this JSON.Value to String. Use JSON.dump() instead.

Returns:

toBoolean

public Boolean toBoolean()

toInt

public Int toInt()

toLong

public Long toLong()

toDouble

public Double toDouble()

clone

public JSON.Value clone()