--- /dev/null
+/*\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