Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 76d7e20a authored by Jesse Wilson's avatar Jesse Wilson
Browse files

A new streaming JSON API. 

Change-Id: Iefa7ee44ddacbe22ea9ebca3165ac59030659bf2
parent fdde0003

api/current.xml

+392 −0
Original line number Diff line number Diff line
@@ -180176,6 +180176,398 @@ 
</parameter>

</method>

</class>

<class name="JsonReader"

 extends="java.lang.Object"

 abstract="false"

 static="false"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<implements name="java.io.Closeable">

</implements>

<constructor name="JsonReader"

 type="android.util.JsonReader"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="in" type="java.io.Reader">

</parameter>

</constructor>

<method name="booleanValue"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="close"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="doubleValue"

 return="double"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="intValue"

 return="int"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="isInt"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="isLong"

 return="boolean"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="longValue"

 return="long"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="name"

 return="java.lang.String"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

<method name="name"

 return="java.lang.String"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="defaultName" type="java.lang.String">

</parameter>

</method>

<method name="next"

 return="android.util.JsonToken"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="skipValue"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="stringValue"

 return="java.lang.String"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

</method>

</class>

<class name="JsonToken"

 extends="java.lang.Enum"

 abstract="false"

 static="false"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<method name="valueOf"

 return="android.util.JsonToken"

 abstract="false"

 native="false"

 synchronized="false"

 static="true"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="name" type="java.lang.String">

</parameter>

</method>

<method name="values"

 return="android.util.JsonToken[]"

 abstract="false"

 native="false"

 synchronized="false"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</method>

</class>

<class name="JsonWriter"

 extends="java.lang.Object"

 abstract="false"

 static="false"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<constructor name="JsonWriter"

 type="android.util.JsonWriter"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="out" type="java.io.Writer">

</parameter>

</constructor>

<method name="beginArray"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="beginObject"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="close"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="endArray"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="endObject"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="flush"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="name"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="name" type="java.lang.String">

</parameter>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="nullValue"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="setIndentSpaces"

 return="void"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="indent" type="int">

</parameter>

</method>

<method name="value"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="value" type="java.lang.String">

</parameter>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="value"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="value" type="boolean">

</parameter>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="value"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="value" type="double">

</parameter>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

<method name="value"

 return="android.util.JsonWriter"

 abstract="false"

 native="false"

 synchronized="false"

 static="false"

 final="false"

 deprecated="not deprecated"

 visibility="public"

>

<parameter name="value" type="long">

</parameter>

<exception name="IOException" type="java.io.IOException">

</exception>

</method>

</class>

<class name="Log"

 extends="java.lang.Object"

 abstract="false"

core/java/android/util/JsonReader.java

0 → 100644
+1006 −0

File added.

Preview size limit exceeded, changes collapsed.

core/java/android/util/JsonScope.java

0 → 100644
+68 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2010 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package android.util;



/**

 * Lexical scoping elements within a JSON reader or writer.

 */

enum JsonScope {



    /**

     * An array with no elements requires no separators or newlines before

     * it is closed.

     */

    EMPTY_ARRAY,



    /**

     * A array with at least one value requires a comma and newline before

     * the next element.

     */

    NONEMPTY_ARRAY,



    /**

     * An object with no name/value pairs requires no separators or newlines

     * before it is closed.

     */

    EMPTY_OBJECT,



    /**

     * An object whose most recent element is a key. The next element must

     * be a value.

     */

    DANGLING_NAME,



    /**

     * An object with at least one name/value pair requires a comma and

     * newline before the next element.

     */

    NONEMPTY_OBJECT,



    /**

     * No object or array has been started.

     */

    EMPTY_DOCUMENT,



    /**

     * A document with at an array or object.

     */

    NONEMPTY_DOCUMENT,



    /**

     * A document that's been closed and cannot be accessed.

     */

    CLOSED,

}

core/java/android/util/JsonToken.java

0 → 100644
+82 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2010 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package android.util;



/**

 * A structure, name or value type in a JSON-encoded string.

 */

public enum JsonToken {



    /**

     * The opening of a JSON array. Written using {@link JsonWriter#beginObject}

     * and read using {@link JsonReader#beginObject}.

     */

    BEGIN_ARRAY,



    /**

     * The closing of a JSON array. Written using {@link JsonWriter#endArray}

     * and read using {@link JsonReader#endArray}.

     */

    END_ARRAY,



    /**

     * The opening of a JSON object. Written using {@link JsonWriter#beginObject}

     * and read using {@link JsonReader#beginObject}.

     */

    BEGIN_OBJECT,



    /**

     * The closing of a JSON object. Written using {@link JsonWriter#endObject}

     * and read using {@link JsonReader#endObject}.

     */

    END_OBJECT,



    /**

     * A JSON property name. Within objects, tokens alternate between names and

     * their values. Written using {@link JsonWriter#name} and read using {@link

     * JsonReader#nextName}

     */

    NAME,



    /**

     * A JSON string.

     */

    STRING,



    /**

     * A JSON number represented in this API by a Java {@code double}, {@code

     * long}, or {@code int}.

     */

    NUMBER,



    /**

     * A JSON {@code true} or {@code false}.

     */

    BOOLEAN,



    /**

     * A JSON {@code null}.

     */

    NULL,



    /**

     * The end of the JSON stream. This sentinel value is returned by {@link

     * JsonReader#peek()} to signal that the JSON-encoded value has no more

     * tokens.

     */

    END_DOCUMENT

}

core/java/android/util/JsonWriter.java

0 → 100644
+475 −0

File added.

Preview size limit exceeded, changes collapsed.