com.kontakt.sdk.android.common.util

Class JSONUtils

java.lang.Object

com.kontakt.sdk.android.common.util.JSONUtils

public final class JSONUtils
extends java.lang.Object

JSON utility methods.

Method Summary

Modifier and Type	Method and Description
static boolean	getBoolean(JSONObject jsonObject, java.lang.String key, boolean defaultValue) Gets boolean value bound with specified key.
static java.lang.Boolean	getBooleanBoxed(JSONObject jsonObject, java.lang.String key)
static double	getDouble(JSONObject jsonObject, java.lang.String key, double defaultValue) Gets double value bound with specified key.
static int	getInt(JSONObject jsonObject, java.lang.String key, int defaultValue) Gets int value bound with specified key.
static JSONArray	getJSONArray(JSONObject jsonObject, java.lang.String key, JSONArray defaultValue)
static java.lang.String	getJSONArrayElement(JSONArray sourceArray, int index)
static JSONObject	getJSONObject(JSONArray sourceObject, int index)
static long	getLong(JSONObject jsonObject, java.lang.String key, long defaultValue) Gets long value bound with specified key.
static java.lang.String	getString(JSONObject jsonObject, java.lang.String key, java.lang.String defaultValue) Gets string value bound with specified key.
static java.lang.String	getStringOrNull(JSONObject jsonObject, java.lang.String key) Gets string or null.
static java.util.UUID	getUUID(JSONObject jsonObject, java.lang.String key, java.util.UUID defaultValue) Gets UUID value bound with specified key.
static java.util.UUID	getUUIDOrNull(JSONObject jsonObject, java.lang.String key) Gets UUID value bound with specified key or null if the key does not exist.
static boolean	hasJSONKey(JSONObject jsonObject, java.lang.String key) Checks whether JSONObject contains specified key with non-null value.
static <T> T	transformOrReturnNull(JSONObject jsonObject, java.lang.String jsonEntry, SDKFunction<JSONObject,T> convertFunction) Transform JSONObject's property accessible under specified entry to desired instance or return null.
static <T> T	transformOrThrow(JSONArray jsonArray, SDKThrowableFunction<JSONArray,T,java.lang.Exception> transformFunction) Transform JSONArray to desired type.
static <T> T	transformOrThrow(JSONObject jsonObject, SDKThrowableFunction<JSONObject,T,java.lang.Exception> transformFunction) Transform JSONObject to desired type.
static <T> java.util.List<T>	transformToListOrReturnEmpty(JSONObject jsonObject, java.lang.String tag, SDKFunction<JSONObject,T> function) Transform to list or return empty.

Methods inherited from class java.lang.Object

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

Method Detail

hasJSONKey

public static boolean hasJSONKey(JSONObject jsonObject,
                                 java.lang.String key)

Checks whether JSONObject contains specified key with non-null value.

Parameters:

jsonObject - the json object

key - the key

Returns:

the boolean

getString

public static java.lang.String getString(JSONObject jsonObject,
                                         java.lang.String key,
                                         java.lang.String defaultValue)

Gets string value bound with specified key. If the value is null, default value is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the string

getInt

public static int getInt(JSONObject jsonObject,
                         java.lang.String key,
                         int defaultValue)

Gets int value bound with specified key. If the value is null, default int value is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the int

getLong

public static long getLong(JSONObject jsonObject,
                           java.lang.String key,
                           long defaultValue)

Gets long value bound with specified key. If the value is null, default long value is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the long

getDouble

public static double getDouble(JSONObject jsonObject,
                               java.lang.String key,
                               double defaultValue)

Gets double value bound with specified key. If the value is null, default double value is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the double

getUUID

public static java.util.UUID getUUID(JSONObject jsonObject,
                                     java.lang.String key,
                                     java.util.UUID defaultValue)

Gets UUID value bound with specified key. If the value is null, default UUID is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the uUID

getUUIDOrNull

public static java.util.UUID getUUIDOrNull(JSONObject jsonObject,
                                           java.lang.String key)

Gets UUID value bound with specified key or null if the key does not exist.

Parameters:

jsonObject - the json object

key - the key

Returns:

the uUID or null

getStringOrNull

public static java.lang.String getStringOrNull(JSONObject jsonObject,
                                               java.lang.String key)

Gets string or null.

Parameters:

jsonObject - the json object

key - the key

Returns:

the string or null

getBoolean

public static boolean getBoolean(JSONObject jsonObject,
                                 java.lang.String key,
                                 boolean defaultValue)

Gets boolean value bound with specified key. If the value does not exist or is null, default value is returned.

Parameters:

jsonObject - the json object

key - the key

defaultValue - the default value

Returns:

the boolean

getBooleanBoxed

public static java.lang.Boolean getBooleanBoxed(JSONObject jsonObject,
                                                java.lang.String key)

getJSONArray

public static JSONArray getJSONArray(JSONObject jsonObject,
                                     java.lang.String key,
                                     JSONArray defaultValue)

getJSONObject

public static JSONObject getJSONObject(JSONArray sourceObject,
                                       int index)

getJSONArrayElement

public static java.lang.String getJSONArrayElement(JSONArray sourceArray,
                                                   int index)

transformOrThrow

public static <T> T transformOrThrow(JSONObject jsonObject,
                                     SDKThrowableFunction<JSONObject,T,java.lang.Exception> transformFunction)

Transform JSONObject to desired type.

Type Parameters:

T - the type parameter

Parameters:

jsonObject - the json object

transformFunction - the throwable function

Returns:

the instance of desired type

Throws:

java.lang.IllegalStateException - in case of failure

transformOrThrow

public static <T> T transformOrThrow(JSONArray jsonArray,
                                     SDKThrowableFunction<JSONArray,T,java.lang.Exception> transformFunction)

Transform JSONArray to desired type.

Type Parameters:

T - the type parameter

Parameters:

jsonArray - the json array

transformFunction - the throwable function

Returns:

the t

Throws:

java.lang.IllegalStateException - in case of failure

transformToListOrReturnEmpty

public static <T> java.util.List<T> transformToListOrReturnEmpty(JSONObject jsonObject,
                                                                 java.lang.String tag,
                                                                 SDKFunction<JSONObject,T> function)

Transform to list or return empty.

Type Parameters:

T - the type parameter

Parameters:

jsonObject - the json object

tag - the tag

function - the function

Returns:

the list

transformOrReturnNull

public static <T> T transformOrReturnNull(JSONObject jsonObject,
                                          java.lang.String jsonEntry,
                                          SDKFunction<JSONObject,T> convertFunction)

Transform JSONObject's property accessible under specified entry to desired instance or return null.

Type Parameters:

T - the type parameter

Parameters:

jsonObject - the json object

jsonEntry - the json entry

convertFunction - the convert function

Returns:

the t