public class

JSONParser

extends Object
java.lang.Object
   ↳ com.google.gwt.json.client.JSONParser

Class Overview

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

See Also

Summary

Public Methods
static JSONValue parse(String jsonString)
This method is 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.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public static JSONValue parse (String jsonString)

This method is 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

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

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