Skip to content
No description, website, or topics provided.
Java
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
JsonArray.java Added JsonUtilsSimple Dec 23, 2018
JsonObject.java Added JsonUtilsSimple Dec 23, 2018
JsonType.java Version 2: Added support of Parsing Json String / List Sep 2, 2018
JsonUtils.java Upgrade version code to 3 Dec 23, 2018
JsonUtilsSimple.java Added JsonUtilsSimple Dec 23, 2018
LICENSE
README.md Fixed README.md document issue: json format error Dec 23, 2018
translation.json Added JsonUtilsSimple Dec 23, 2018

README.md

JsonUtils

Some Json utilities for App Inventor (& Thunkable etc.)

Download (Releases)

Defined JsonType(s)

Developers can use these as texts when using join-text block (although they are not accepted by some blocks)
For the other use, please be careful that it is not a strict String type and may causes problem.
So a prefered way to convert this into a strict String via a join-text block.

  • JsonArray
    • JsonArray is a container of org.json.JSONArray. It is defined for functions like JsonArray_Append
    • Can be parsed as a Json array String, e.g. [], ["1", 2, true]
  • JsonObject
    • JsonObject is a container of org.json.JSONObject. It is defined for functions like JsonObject_Put
    • Can be parsed as a Json object String, e.g. {}, {"number":1, "text":"foobar", "boolean":true}
  • JSONArray & JSONObject
    • These are native Android types, usually you don't need to know about them.

The following table is about converting different types to each other

image

Functions

image

  • CanParseJsonObject
    • Check if the List can be parsed into a JsonObject
    • parameters:
      • list
    • returns:
      • boolean (true / false)
  • Json2List
    • Parse a json string / JsonArray / JsonObject into a List
    • parameters:
      • a Json String / JsonArray / JsonObject to be parsed
    • returns:
      • a list that represents the json

image

  • JsonArray_Append
    • Append an value. This increases the array's length by one.
    • parameters:
      • JsonArray
      • value (any)
  • JsonArray_CreateEmpty
    • returns:
      • a empty JsonArray (json string: [])
  • JsonArray_Get
    • Get the object value associated with an index. Return null if there is no object at that index.
    • parameters:
      • JsonArray
      • index of the item (index start from 1)
    • returns:
      • the value of the item

image

  • JsonArray_Length
    • Get the number of elements in the JsonArray, included nulls.
    • parameters:
      • JsonArray
    • returns:
      • the length of the JsonArray
  • JsonArray_Put
    • Put or replace an object value in the JSONArray. If the index is greater than the length of the JSONArray, then null elements will be added as necessary to pad it out.
    • parameters:
      • JsonArray
      • index of the item (index start from 1)
      • value to be put
  • JsonArray_Remove
    • Remove an index and close the hole.
    • parameters:
      • JsonArray
      • index of the item (index start from 1)

image

  • JsonObject_Contains
    • Determine if the JSONObject contains a specific key.
    • parameters:
      • JsonObject
      • key (String) of the item
    • returns:
      • if the key exists in JsonObject
  • JsonObject_CreateEmpty
    • returns:
      • a empty JsonObject (json string: {})
  • JsonObject_Get
    • Get the value object associated with a key. Returns null if there is no value.
    • parameters:
      • JsonObject
      • key (String) of the item
    • returns:
      • value of the key paired up to
  • JsonObject_GetKeyList
    • List all keys in the JsonObject
    • parameters:
      • jsonObject
    • returns:
      • a list that contains all keys exist in the jsonObject

image

  • JsonObject_Put
    • Put a key-value pair in the JsonObject.
    • parameters:
      • JsonObject
      • key (String) of the item
      • value to be put
  • JsonObject_Remove
    • Remove a key and its value, if present.
    • parameters:
      • JsonObject
      • key (String) of the item
  • JsonObject_Size
    • Get the number of keys stored in the JsonObject.
    • parameters:
      • JsonObject
    • returns:
      • number of the key-value pairs

image

  • Json_GetPath
    • Get a value from JsonArray / JsonObject with a path.
    • parameters:
      • json
      • path
    • returns:
      • (value) / null
    • example:
      • json=[1,[1,2,3,{"key":"valueWanted"}],3]
      • path=2.4.key
      • result="valueWanted"
  • Json_PutPath
    • Put a value into JsonArray / JsonObject with a path.
    • parameters:
      • json
      • path
      • value
    • example:
      • json=[1,[1,2,3,{"key":"value"}],3]
      • path=2.4.key
      • value="newValue"
      • json after put: [1,[1,2,3,{"key":"newValue"}],3]
  • List2JsonString
    • DEPRECATED, use ToJsonString(object) instead

image

  • ParseJsonString
    • Parse a json string into a JsonArray / JsonObject
    • parameters:
      • Json String
    • returns:
      • a corresponding JsonArray / JsonObject
  • ParseList
    • Parse a list into a JsonArray / JsonObject
    • parameters:
      • list
    • returns:
      • a corresponding JsonArray / JsonObject
  • ToJsonString
    • Convert an App Inventor list into a json string
    • parameters:
      • object - list / JsonArray / JsonObject
        • list: Any App Inventor list except for lists of key-value pairs would be considered as a JsonArray. List of key-value pairs: list with all list items are lists with two items and the first list item is a text). e.g. ((key1 value1) (key2 value2))
    • returns:
      • corresponding Json String

image

  • isAJsonArray
    • Check if an object is a JsonArray
  • isAJsonArrayOrObject
    • Check if an object is a JsonArray or a JsonObject
  • isAJsonObject
    • Check if an object is a JsonObject
  • isJsonObject
    • DEPRECATED use CanParseJsonObject(list) instead
  • isNull
    • Check if an object is null
You can’t perform that action at this time.