Package com.google.gwt.json.client

Class JSONObject

java.lang.Object

com.google.gwt.json.client.JSONValue

com.google.gwt.json.client.JSONObject

public class JSONObject
extends JSONValue

Represents a JSON object. A JSON object consists of a set of properties.

Constructor Summary

Constructors

Constructor	Description
JSONObject()
JSONObject(JavaScriptObject jsValue)	Creates a new JSONObject from the supplied JavaScript value.

Method Summary

Modifier and Type	Method	Description
boolean	containsKey(String key)	Tests whether or not this JSONObject contains the specified property.
boolean	equals(Object other)	Returns true if other is a JSONObject wrapping the same underlying object.
JSONValue	get(String key)	Gets the JSONValue associated with the specified property.
JavaScriptObject	getJavaScriptObject()	Returns the underlying JavaScript object that this object wraps.
(package private) JavaScriptObject	getUnwrapper()	Internal.
int	hashCode()
JSONObject	isObject()	Returns this, as this is a JSONObject.
Set<String>	keySet()	Returns the set of properties defined on this JSONObject.
JSONValue	put(String key, JSONValue jsonValue)	Assign the specified property to the specified value in this JSONObject.
int	size()	Determines the number of properties on this object.
String	toString()	Converts a JSONObject into a JSON representation that can be used to communicate with a JSON service.

Methods inherited from class com.google.gwt.json.client.JSONValue

isArray, isBoolean, isNull, isNumber, isString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

JSONObject

public JSONObject()

JSONObject

public JSONObject(JavaScriptObject jsValue)

Creates a new JSONObject from the supplied JavaScript value.

Method Details

containsKey

public boolean containsKey(String key)

Tests whether or not this JSONObject contains the specified property.

Parameters:

key - the property to search for

Returns:

true if the JSONObject contains the specified property

equals

public boolean equals(Object other)

Returns true if other is a JSONObject wrapping the same underlying object.

Overrides:

equals in class Object

get

public JSONValue get(String key)

Gets the JSONValue associated with the specified property.

Parameters:

key - the property to access

Returns:

the value of the specified property, or null if the property does not exist

Throws:

NullPointerException - if key is null

getJavaScriptObject

public JavaScriptObject getJavaScriptObject()

Returns the underlying JavaScript object that this object wraps.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isObject

public JSONObject isObject()

Returns this, as this is a JSONObject.

Overrides:

isObject in class JSONValue

Returns:

a reference to a JSONObject if this JSONValue is a JSONObject or null otherwise.

keySet

public Set<String> keySet()

Returns the set of properties defined on this JSONObject. The returned set is immutable.

put

public JSONValue put(String key,
 JSONValue jsonValue)

Assign the specified property to the specified value in this JSONObject. If the property already has an associated value, it is overwritten.

Parameters:

key - the property to assign

jsonValue - the value to assign

Returns:

the previous value of the property, or null if the property did not exist

Throws:

NullPointerException - if key is null

size

public int size()

Determines the number of properties on this object.

toString

public String toString()

Converts a JSONObject into a JSON representation that can be used to communicate with a JSON service.

Specified by:

toString in class JSONValue

Returns:

a JSON string representation of this JSONObject instance

getUnwrapper

JavaScriptObject getUnwrapper()

Description copied from class: JSONValue

Internal. Returns a JS func that can unwrap this value. Used from native code.

Specified by:

getUnwrapper in class JSONValue