JSON

simple and easy json parser, json generator, and data holder based on JSONArray and JSONObject for android,
like SwiftyJSON but for android

Add to your project

To use JSON you must add it as a dependency in your Gradle build:

Step 1. Add the JitPack repository to your build file Add it in your root build.gradle at the end of repositories:

allprojects {
  repositories {
   ...
   maven { url "https://jitpack.io" }
  }
 }

Step 2. Add the dependency

dependencies {
    compile 'com.github.amirdew:JSON:v1.0.0'
}

Usage - parse json

You can create JSON object from string and access data with key() and index() methods.

String simpleJsonString = "{\"id\":1,\"name\":\"A green door\",\"price\":12.5,\"tags\":[\"home\",\"green\"]}";

JSON json = new JSON(simpleJsonString);
        
//access data
String firstTag = json.key("tags").index(0).stringValue();
Double price = json.key("price").doubleValue();

products json:

[
  {
    "id": 2,
    "name": "An ice sculpture",
    "price": 12.50,
    "tags": ["cold", "ice"],
    "dimensions": {
      "length": 7.0,
      "width": 12.0,
      "height": 9.5
    },
    "warehouseLocation": {
      "latitude": -78.75,
      "longitude": 20.4
    }
  },
  {
    "id": 3,
    "name": "A blue mouse",
    "price": 25.50,
    "dimensions": {
      "length": 3.1,
      "width": 1.0,
      "height": 1.0
    },
    "warehouseLocation": {
      "latitude": 54.4,
      "longitude": -32.7
    }
  }
]

loop:

for(int i=0; i<products.count(); i++){
   
   json productInfo = products.index(i);
   String productName = productInfo.key("name").stringValue();
}

JSON is exception and null free, you can use key() and index() many times without worry about any exception.

 int someValue = products.index(8).key("someKey").index(1).key("someOther").intValue();
 //someValue = 0

check index or key is exist or is null:

 if( products.index(3).key("someKey").isNull() ){ 
    /*...*/ 
 }

if( products.index(1).key("someKey").exist() ){
   /*...*/ 
 }

Available methods - parse

Method	Input type	Return type	Default	Description
key()	String	JSON	-	if object is a dictionary return JSON object with input key
index()	int	JSON	-	if object is a array return JSON object with input index
stringValue()	-	String	empty string ("")	return .toString() of object
intValue()	-	int	0	return integer value if possible
longValue()	-	long	0	return long value if possible
doubleValue()	-	Double	0	return Double value if possible
booleanValue()	-	boolean	false	return true if object is kind of boolean and true or is kind of string and equal "true"
value()	-	Object	-	return related object
count()	-	int	0	if related object is a dictionary return number of keys, if related object is a array return length of array
isNull()	-	boolean	-	return true if related object is null
exist()	-	boolean	-	return true if related object with index or key exists
getJsonArray()	-	JSONArray	null	return related JSONArray
getJsonObject()	-	JSONObject	null	return related JSONObject

Usage - generate json, data holding

You can use JSON.dic() and JSON.array() static methods to generate json string or hold and pass data

  JSON generatedJsonObject = JSON.create(
                JSON.dic(
                        "someKey", "someValue",
                        "someArrayKey", JSON.array(
                                "first",
                                1,
                                2,
                                JSON.dic(
                                        "emptyArrayKey", JSON.array()
                                )
                        )
                )
        );
        
        
  String jsonString = generatedJsonObject.toString();

result:

{
  "someKey": "someValue",
  "someArrayKey": [
    "first",
    1,
    2,
    {
      "emptyArrayKey": []
    }
  ]
}

add, edit, remove:

note: now its work for first level only

  generatedJsonObject.addEditWithKey("someArrayKey","someOtherValue");

result:

{
  "someKey": "someValue",
  "someArrayKey": "someOtherValue"
}

Available methods - generate, edit, remove

Method	Input type	Description
add()	Object	if current related object is an array add object at end of array
remove()	Object	if current related object is an array and input object exist, remove it from array
addWithIndex()	Object, int	if current related object is an array replace input object with object for input index
removeWithIndex()	int	if current related object is an array remove object for input index
addEditWithKey()	String, Object	if current related object is a dictionary add input object with input key
removeWithKey()	String	if current related object is a dictionary remove object with input key
static create()	Object	create new instance of JSON with input object
static dic()	Object...	if number of input objects is even create JSONObject use even objects as key and odd obejcts as value
static array()	Object...	create JSONArray use input objects

JSON Parser

General

Additional

Announcement