org.restlet.client.ext.json

Class JsonRepresentation

java.lang.Object

org.restlet.client.representation.Variant

org.restlet.client.representation.RepresentationInfo

org.restlet.client.representation.Representation

org.restlet.client.ext.json.JsonRepresentation

public class JsonRepresentation
extends Representation

JSON representation based on an JSON value. JSON (JavaScript Object Notation) is a common serialization format similar to XML but lighter.

Author:

Jerome Louvel

See Also:

JSON

Field Summary

Fields inherited from class org.restlet.client.representation.Representation

UNKNOWN_SIZE

Constructor Summary

Constructors

Constructor and Description
JsonRepresentation(MediaType mediaType) Constructor for an empty document.
JsonRepresentation(MediaType mediaType, com.google.gwt.json.client.JSONValue value) Constructor from an existing DOM document.
JsonRepresentation(Representation jsonRepresentation) Constructor.
JsonRepresentation(java.lang.String jsonString) Constructor from a JSON string.

Method Summary

Modifier and Type	Method and Description
com.google.gwt.json.client.JSONArray	getJsonArray() Converts the representation to a JSON array.
com.google.gwt.json.client.JSONBoolean	getJsonBoolean() Converts the representation to a JSON Boolean.
com.google.gwt.json.client.JSONNull	getJsonNull() Converts the representation to a JSON null value.
com.google.gwt.json.client.JSONObject	getJsonObject() Converts the representation to a JSON object.
com.google.gwt.json.client.JSONString	getJsonString() Converts the representation to a JSON string.
java.io.Reader	getReader()
long	getSize()
java.io.InputStream	getStream()
java.lang.String	getText()
com.google.gwt.json.client.JSONValue	getValue() Returns the wrapped JSON value.
void	release() Releases the wrapped JSON value and the source JSON representation if they have been defined.
void	setValue(com.google.gwt.json.client.JSONValue json) Sets the wrapped JSON value.

Methods inherited from class org.restlet.client.representation.Representation

append, exhaust, getAvailableSize, getDisposition, getExpirationDate, getRange, hasKnownSize, isAvailable, isEmpty, isTransient, setAvailable, setDisposition, setExpirationDate, setRange, setSize, setTransient

Methods inherited from class org.restlet.client.representation.RepresentationInfo

getModificationDate, getTag, setModificationDate, setTag

Methods inherited from class org.restlet.client.representation.Variant

createClientInfo, equals, getCharacterSet, getEncodings, getLanguages, getLocationRef, getMediaType, hashCode, includes, isCompatible, setCharacterSet, setEncodings, setLanguages, setLocationRef, setLocationRef, setMediaType, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonRepresentation

public JsonRepresentation(MediaType mediaType)

Constructor for an empty document.

Parameters:

mediaType - The representation's media type.

JsonRepresentation

public JsonRepresentation(MediaType mediaType,
                          com.google.gwt.json.client.JSONValue value)

Constructor from an existing DOM document.

Parameters:

mediaType - The representation's media type.

value - The source JSON value.

JsonRepresentation

public JsonRepresentation(Representation jsonRepresentation)

Constructor.

Parameters:

jsonRepresentation - A source JSON representation to parse.

JsonRepresentation

public JsonRepresentation(java.lang.String jsonString)

Constructor from a JSON string.

Parameters:

jsonString - The JSON string.

Method Detail

getJsonArray

public com.google.gwt.json.client.JSONArray getJsonArray()
                                                  throws java.io.IOException

Converts the representation to a JSON array. This method might trigger the parsing of the wrapped JSON textual representation.

Returns:

The converted JSON array.

Throws:

java.io.IOException

getJsonBoolean

public com.google.gwt.json.client.JSONBoolean getJsonBoolean()
                                                      throws java.io.IOException

Converts the representation to a JSON Boolean. This method might trigger the parsing of the wrapped JSON textual representation.

Returns:

The converted JSON Boolean.

Throws:

java.io.IOException

getJsonNull

public com.google.gwt.json.client.JSONNull getJsonNull()
                                                throws java.io.IOException

Converts the representation to a JSON null value. This method might trigger the parsing of the wrapped JSON textual representation.

Returns:

The converted JSON null value.

Throws:

java.io.IOException

getJsonObject

public com.google.gwt.json.client.JSONObject getJsonObject()
                                                    throws java.io.IOException

Converts the representation to a JSON object. This method might trigger the parsing of the wrapped JSON textual representation.

Returns:

The converted JSON object.

Throws:

java.io.IOException

getJsonString

public com.google.gwt.json.client.JSONString getJsonString()
                                                    throws java.io.IOException

Converts the representation to a JSON string. This method might trigger the parsing of the wrapped JSON textual representation.

Returns:

The converted JSON string.

Throws:

java.io.IOException

getReader

public java.io.Reader getReader()
                         throws java.io.IOException

Specified by:

getReader in class Representation

Throws:

java.io.IOException

getSize

public long getSize()

Overrides:

getSize in class Representation

getStream

public java.io.InputStream getStream()
                              throws java.io.IOException

Specified by:

getStream in class Representation

Throws:

java.io.IOException

getText

public java.lang.String getText()
                         throws java.io.IOException

Specified by:

getText in class Representation

Throws:

java.io.IOException

getValue

public com.google.gwt.json.client.JSONValue getValue()
                                              throws java.io.IOException

Returns the wrapped JSON value. If no value is defined yet, it attempts to parse the JSON representation eventually given at construction time. Otherwise, it just creates a null JSON value.

Returns:

The wrapped DOM document.

Throws:

java.io.IOException

release

public void release()

Releases the wrapped JSON value and the source JSON representation if they have been defined.

Overrides:

release in class Representation

setValue

public void setValue(com.google.gwt.json.client.JSONValue json)

Sets the wrapped JSON value.

Parameters:

json - The wrapped JSON value.