com.google.appinventor.components.runtime.util

Class JsonUtil

java.lang.Object

com.google.appinventor.components.runtime.util.JsonUtil

public class JsonUtil
extends java.lang.Object

Provides utility functions to convert between Java object and JSON.

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.Object	convertJsonItem(java.lang.Object o) Returns a Java object representation of objects that are encountered inside of JSON created using the org.json package.
static java.lang.String	getJsonRepresentation(java.lang.Object value)
static java.util.List<java.lang.Object>	getListFromJsonArray(org.json.JSONArray jArray) Returns a Java Object list of a JSONArray with each item in the array converted using convertJsonItem().
static java.util.List<java.lang.Object>	getListFromJsonObject(org.json.JSONObject jObject) Returns a list containing one two item list per key in jObject.
static java.lang.Object	getObjectFromJson(java.lang.String jsonString)
static java.util.List<java.lang.String>	getStringListFromJsonArray(org.json.JSONArray jArray) Returns a list of String objects from a JSONArray.

Methods inherited from class java.lang.Object

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

Method Detail

getStringListFromJsonArray

public static java.util.List<java.lang.String> getStringListFromJsonArray(org.json.JSONArray jArray)
                                                                   throws org.json.JSONException

Returns a list of String objects from a JSONArray. This does not do any kind of recursive unpacking of the array. Thus, if the array includes other JSON arrays or JSON objects their string representation will be a single item in the returned list.

Parameters:

jArray - The JSONArray to convert.

Returns:

A List of the String representation of each item in the JSON array.

Throws:

org.json.JSONException - if an element of jArray cannot be converted to a String.

getListFromJsonArray

public static java.util.List<java.lang.Object> getListFromJsonArray(org.json.JSONArray jArray)
                                                             throws org.json.JSONException

Returns a Java Object list of a JSONArray with each item in the array converted using convertJsonItem().

Parameters:

jArray - The JSONArray to convert.

Returns:

A List of Strings and more Object lists.

Throws:

org.json.JSONException - if an element in jArray cannot be converted properly.

getListFromJsonObject

public static java.util.List<java.lang.Object> getListFromJsonObject(org.json.JSONObject jObject)
                                                              throws org.json.JSONException

Returns a list containing one two item list per key in jObject. Each two item list has the key String as its first element and the result of calling convertJsonItem() on its value as the second element. The sub-lists in the returned list will appear in alphabetical order by key.

Parameters:

jObject - The JSONObject to convert.

Returns:

A list of two item lists: [String key, Object value].

Throws:

org.json.JSONException - if an element in jObject cannot be converted properly.

convertJsonItem

public static java.lang.Object convertJsonItem(java.lang.Object o)
                                        throws org.json.JSONException

Returns a Java object representation of objects that are encountered inside of JSON created using the org.json package. JSON arrays and objects are transformed into their list representations using getListFromJsonArray and getListFromJsonObject respectively. Java Boolean values and the Strings "true" and "false" (case insensitive) are inserted as Booleans. Java Numbers are inserted without modification and all other values are inserted as their toString(). value.

Parameters:

o - An item in a JSON array or JSON object to convert.

Returns:

A Java Object representing o or the String "null" if o is null.

Throws:

org.json.JSONException - if o fails to parse.

getJsonRepresentation

public static java.lang.String getJsonRepresentation(java.lang.Object value)
                                              throws org.json.JSONException

Throws:

org.json.JSONException

getObjectFromJson

public static java.lang.Object getObjectFromJson(java.lang.String jsonString)
                                          throws org.json.JSONException

Throws:

org.json.JSONException