Clean up previous commit and tabify source files

[unical.git] / gson / com / google / gson / JsonParser.java

/*\r
 * Copyright (C) 2009 Google Inc.\r
 *\r
 * Licensed under the Apache License, Version 2.0 (the "License");\r
 * you may not use this file except in compliance with the License.\r
 * You may obtain a copy of the License at\r
 *\r
 * http://www.apache.org/licenses/LICENSE-2.0\r
 *\r
 * Unless required by applicable law or agreed to in writing, software\r
 * distributed under the License is distributed on an "AS IS" BASIS,\r
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
 * See the License for the specific language governing permissions and\r
 * limitations under the License.\r
 */\r
package com.google.gson;\r
\r
import java.io.IOException;\r
import java.io.Reader;\r
import java.io.StringReader;\r
\r
import com.google.gson.internal.Streams;\r
import com.google.gson.stream.JsonReader;\r
import com.google.gson.stream.JsonToken;\r
import com.google.gson.stream.MalformedJsonException;\r
\r
/**\r
 * A parser to parse Json into a parse tree of {@link JsonElement}s\r
 *\r
 * @author Inderjeet Singh\r
 * @author Joel Leitch\r
 * @since 1.3\r
 */\r
public final class JsonParser {\r
\r
  /**\r
   * Parses the specified JSON string into a parse tree\r
   *\r
   * @param json JSON text\r
   * @return a parse tree of {@link JsonElement}s corresponding to the specified JSON\r
   * @throws JsonParseException if the specified text is not valid JSON\r
   * @since 1.3\r
   */\r
  public JsonElement parse(String json) throws JsonSyntaxException {\r
    return parse(new StringReader(json));\r
  }\r
\r
  /**\r
   * Parses the specified JSON string into a parse tree\r
   *\r
   * @param json JSON text\r
   * @return a parse tree of {@link JsonElement}s corresponding to the specified JSON\r
   * @throws JsonParseException if the specified text is not valid JSON\r
   * @since 1.3\r
   */\r
  public JsonElement parse(Reader json) throws JsonIOException, JsonSyntaxException {\r
    try {\r
      JsonReader jsonReader = new JsonReader(json);\r
      JsonElement element = parse(jsonReader);\r
      if (!element.isJsonNull() && jsonReader.peek() != JsonToken.END_DOCUMENT) {\r
        throw new JsonSyntaxException("Did not consume the entire document.");\r
      }\r
      return element;\r
    } catch (MalformedJsonException e) {\r
      throw new JsonSyntaxException(e);\r
    } catch (IOException e) {\r
      throw new JsonIOException(e);\r
    } catch (NumberFormatException e) {\r
      throw new JsonSyntaxException(e);\r
    }\r
  }\r
\r
  /**\r
   * Returns the next value from the JSON stream as a parse tree.\r
   *\r
   * @throws JsonParseException if there is an IOException or if the specified\r
   *     text is not valid JSON\r
   * @since 1.6\r
   */\r
  public JsonElement parse(JsonReader json) throws JsonIOException, JsonSyntaxException {\r
    boolean lenient = json.isLenient();\r
    json.setLenient(true);\r
    try {\r
      return Streams.parse(json);\r
    } catch (StackOverflowError e) {\r
      throw new JsonParseException("Failed parsing JSON source: " + json + " to Json", e);\r
    } catch (OutOfMemoryError e) {\r
      throw new JsonParseException("Failed parsing JSON source: " + json + " to Json", e);\r
    } finally {\r
      json.setLenient(lenient);\r
    }\r
  }\r
}\r