com.google.gwt.json.client

## Class JSONParser

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

-     public class JSONParser
      extends java.lang.Object

  Parses the string representation of a JSON object into a set of JSONValue-derived objects.
  See Also:
    `JSONValue`

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `(package private) static JavaScriptObject` | `typeMap`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `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.
    `(package private) static void` | `throwJSONException(java.lang.String message)`
    `(package private) static void` | `throwUnknownTypeException(java.lang.String typeString)`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### typeMap

          static final JavaScriptObject typeMap

  - ### 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)

      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:
        `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

    - #### throwJSONException

          static void throwJSONException(java.lang.String message)

    - #### throwUnknownTypeException

          static void throwUnknownTypeException(java.lang.String typeString)