Since statically typed languages lack native support for JSON, the Android SDK uses the OptimizelyJSON object to retrieve JSON in a flexible way.

Version

SDK v3.6 and higher

Methods

You can access JSON representations with the following methods:

Method	Parameters	Description
`toString`	none	Returns a string representation of the JSON object
`toMap`	none	Returns a map representation of the JSON object: `(Map<String,Object>)`
`getValue`	`String jsonKey, Class<T> clazz`	Returns a specified schema object (`T`) with the key/value pair of the JSON key you pass to this method. If JSON key is null or empty, it populates your schema object with all JSON key/value pairs. You can retrieve information for a nested member of the JSON data structure by using flattened JSON dot notation. For example, if you want to access the key `nestedField` in `{field1: {nestedField: "blah"}}`, you can call `getValue` with the parameter `"field1.nestedField2"`.

Method

Parameters

Description

toString

none

Returns a string representation of the JSON object

toMap

none

Returns a map representation of the JSON object: (Map<String,Object>)

getValue

String jsonKey, Class<T> clazz

Returns a specified schema object (T) with the key/value pair of the JSON key you pass to this method.

If JSON key is null or empty, it populates your schema object with all JSON key/value pairs.

You can retrieve information for a nested member of the JSON data structure by using flattened JSON dot notation.
For example, if you want to access the key nestedField in {field1: {nestedField: "blah"}}, you can call getValue with the parameter "field1.nestedField2".

The OptimizelyJSON object is defined as follows:

public class OptimizelyJSON {
    public String toString();
  
    public Map<String,Object> toMap();
  
    public <T> T getValue(@Nullable String jsonKey, Class<T> clazz) throws JsonParseException
}

Examples

You can easily use the OptimizelyJSON object, for example to:

Get a JSON string by calling the toString method, or
Retrieve a specified schema from the OptimizelyJSON object by calling the getValue method.

The following example shows how to use an OptimizelyJSON object to populate a schema object you declare.

//declare a schema object into which you want to unmarshal OptimizelyJson content:
data class SSub(var field: String)

data class SObj(
   var field1: Int,
   var field2: Double,
   var field3: String,
   var field4: SSub
)

try {
   //parse all json key/value pairs into your schema, sObj
   val robj = optlyJSON.getValue(null, SObj::class.java)

   //or, parse the specified key/value pair with an integer value
   val rint = optlyJSON.getValue("field1", Int::class.java)

   //or, parse the specified key/value pair with a string value
   val rstr = optlyJSON.getValue("field4.field", String::class.java)
} catch (e: JsonParseException) {
   e.printStackTrace()
}

//declare a schema object into which you want to unmarshal OptimizelyJson content:
class SSub {
   String field;
}

class SObj {
   int field1;
   double field2;
   String field3;
   SSub field4;
}

try {
   //parse all json key/value pairs into your schema, sObj
   SObj robj = optlyJSON.getValue(null, SObj.class);

   //or, parse the specified key/value pair with an integer value
   Integer rint = optlyJSON.getValue("field1", Integer.class);

   //or, parse the specified key/value pair with a string value
   String rstr = optlyJSON.getValue("field4.field", String.class);
} catch (JsonParseException e) {
   e.printStackTrace();
}