com.google.gwt.json.client

Class JSONParser

java.lang.Object

com.google.gwt.json.client.JSONParser

public class JSONParser
extends Object

Parses the string representation of a JSON object into a set of JSONValue-derived objects.

See Also:

JSONValue

Method Summary

Modifier and Type	Method and Description
static JSONValue	parse(String jsonString) Deprecated. use parseStrict(String) or parseLenient(String)
static JSONValue	parseLenient(String jsonString) Evaluates a trusted JSON string and returns its JSONValue representation.
static JSONValue	parseStrict(String jsonString) Evaluates a JSON string and returns its JSONValue representation.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Method Detail

parse

@Deprecated
public static JSONValue parse(String jsonString)

Deprecated. use parseStrict(String) or parseLenient(String)

Evaluates a trusted JSON string and returns its JSONValue representation. CAUTION! This method calls the JavaScript eval() function, which can execute arbitrary script. DO NOT pass an untrusted string into this method.

This method has been deprecated. Please call either parseStrict(String) (for inputs that strictly follow the JSON specification) or parseLenient(String). The implementation of this method calls parseLenient.

Parameters:

jsonString - a JSON object to parse

Returns:

a JSONValue that has been built by parsing the JSON string

Throws:

NullPointerException - if jsonString is null

IllegalArgumentException - if jsonString is empty

parseLenient

public static JSONValue parseLenient(String jsonString)

Evaluates a trusted JSON string and returns its JSONValue representation. CAUTION! This method calls the JavaScript eval() function, which can execute arbitrary script. DO NOT pass an untrusted string into this method.

Parameters:

jsonString - a JSON object to parse

Returns:

a JSONValue that has been built by parsing the JSON string

Throws:

NullPointerException - if jsonString is null

IllegalArgumentException - if jsonString is empty

parseStrict

public static JSONValue parseStrict(String jsonString)

Evaluates a JSON string and returns its JSONValue representation. Where possible, the browser's JSON.parse function is used. For older browsers including IE6 and IE7 that lack a JSON.parse function, the input is validated as described in RFC 4627 for safety and passed to eval().

Parameters:

jsonString - a JSON object to parse

Returns:

a JSONValue that has been built by parsing the JSON string

Throws:

NullPointerException - if jsonString is null

IllegalArgumentException - if jsonString is empty