JSONParser (Google Web Toolkit Javadoc)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

GWT 2.3.0

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.google.gwt.json.client
Class JSONParser

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

public class JSONParser
extends java.lang.Object
extends java.lang.Object

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

See Also:: JSONValue

Method Summary
`static JSONValue`	`parse(java.lang.String jsonString)` Deprecated. use `parseStrict(String)` or `parseLenient(String)`
`static JSONValue`	`parseLenient(java.lang.String jsonString)` Evaluates a trusted JSON string and returns its JSONValue representation.
`static JSONValue`	`parseStrict(java.lang.String jsonString)` Evaluates a JSON string and returns its JSONValue representation.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Method Detail

parse

@Deprecated
public static JSONValue parse(java.lang.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:: java.lang.NullPointerException - if jsonString is null; java.lang.IllegalArgumentException - if jsonString is empty

parseLenient

public static JSONValue parseLenient(java.lang.String jsonString)

Parameters:: jsonString - a JSON object to parse
Returns:: a JSONValue that has been built by parsing the JSON string
Throws:: java.lang.NullPointerException - if jsonString is null; java.lang.IllegalArgumentException - if jsonString is empty

parseStrict

public static JSONValue parseStrict(java.lang.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:: java.lang.NullPointerException - if jsonString is null; java.lang.IllegalArgumentException - if jsonString is empty