lithium.community.android.sdk.utils

Class LiCoreSDKUtils

java.lang.Object

lithium.community.android.sdk.utils.LiCoreSDKUtils

public class LiCoreSDKUtils
extends java.lang.Object

Utility class for common operations.

Method Summary

Modifier and Type	Method and Description
static void	addLSIRequestHeaders(android.content.Context context, Request.Builder builder)
static void	checkArgument(boolean expression, java.lang.String errorTemplate, java.lang.Object... params)
static <T extends java.util.Collection<?>> T	checkCollectionNotEmpty(T collection, java.lang.String errorMessage) Ensures that a collection is not null or empty.
static java.lang.String	checkNotEmpty(java.lang.String str, java.lang.Object errorMessage) Ensures that a string is not null or empty.
static <ArgT> void	checkNotNull(ArgT... argValue) Check that the specified argument value is not null.
static <ArgT> ArgT	checkNotNull(ArgT argValue) Check that the specified argument value is not null.
static <ArgT> ArgT	checkNotNull(ArgT argValue, java.lang.String errorMessage) Check that the specified argument value is not null.
static java.lang.String	checkNullOrNotEmpty(java.lang.String str, java.lang.Object errorMessage) Ensures that the string is either null, or a non-empty string.
static void	closeQuietly(java.io.InputStream in) Close an input stream quietly, i.e.
static java.lang.Long	getLongIfDefined(org.json.JSONObject json, java.lang.String field)
static byte[]	getRandomBytes(java.util.Random rand, int bits) Create a random byte array using a random number generator supplied by the caller.
static java.lang.String	getRandomHexString()
static java.lang.String	getRawString(android.content.Context context, int rawResId) Computes default json as string from raw folder.
static java.lang.String	getString(org.json.JSONObject json, java.lang.String field)
static java.lang.String	getStringIfDefined(org.json.JSONObject json, java.lang.String field)
static int	getThemePrimaryColor(android.content.Context context)
static java.lang.Long	getTime(java.lang.Long time)
static java.util.Map<LiBrowse,java.util.List<LiBaseModel>>	getTransformedResponse(java.util.List<LiBaseModel> response) this method creates a Tree like structure depicting parent child relation for the Category and SubCategory in a community.
static android.net.Uri	getUriIfDefined(org.json.JSONObject json, java.lang.String field)
static java.lang.String	iterableToString(java.lang.Iterable<java.lang.String> strings)
static void	put(org.json.JSONObject json, java.lang.String field, int value)
static void	put(org.json.JSONObject json, java.lang.String field, org.json.JSONArray value)
static void	put(org.json.JSONObject json, java.lang.String field, org.json.JSONObject value) Checks if json, field and value are non null and inserts into JSONObject.
static void	put(org.json.JSONObject json, java.lang.String field, java.lang.String value)
static void	putIfNotNull(org.json.JSONObject json, java.lang.String field, java.lang.Long value)
static void	putIfNotNull(org.json.JSONObject json, java.lang.String field, java.lang.String value) Checks if json and field are non null and inserts into JSONObject.
static void	putIfNotNull(org.json.JSONObject json, java.lang.String field, android.net.Uri value)
static java.lang.String	readInputStream(java.io.InputStream in) Read a string from an input stream.
static void	sendLoginBroadcast(android.content.Context context, boolean isLoginSuccessful, int responseCode)
static java.util.Set<java.lang.String>	stringToSet(java.lang.String spaceDelimitedStr) Converts the consolidated, space-delimited scope string to a set.
static java.lang.String	toHexString(byte[] bytes) Convert a byte[] array to hex string format.

Methods inherited from class java.lang.Object

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

Method Detail

getRandomHexString

public static java.lang.String getRandomHexString()

getRandomBytes

public static byte[] getRandomBytes(java.util.Random rand,
                                    int bits)

Create a random byte array using a random number generator supplied by the caller. To generate a cryptographically strong random sequence, use SecureRandom as the random number generator implementation.

Parameters:

rand - the random number generator to use. Cannot be null.

bits - minimum number of bytes in returned array, actual output may be longer due to rounding.

Returns:

byte array that's ((bits - 1) / 8 + 1) * bytes long.

Throws:

java.lang.IllegalArgumentException - if bits < 1 or bits > 65536 (byte array of length 8192).

toHexString

public static java.lang.String toHexString(byte[] bytes)

Convert a byte[] array to hex string format.

Parameters:

bytes - byte[] buffer to convert to string format

checkNotNull

public static <ArgT> ArgT checkNotNull(ArgT argValue)

Check that the specified argument value is not null. If it is null, throw a IllegalArgumentException

Parameters:

argValue - the argument value to check.

Throws:

java.lang.IllegalArgumentException - if the argument value is null.

checkNotNull

public static <ArgT> void checkNotNull(ArgT... argValue)

Check that the specified argument value is not null. If it is null, throw a IllegalArgumentException

Parameters:

argValue - the argument value to check.

Throws:

java.lang.IllegalArgumentException - if the argument value is null.

checkNotNull

public static <ArgT> ArgT checkNotNull(ArgT argValue,
                                       java.lang.String errorMessage)

Check that the specified argument value is not null. If it is null, throw a IllegalArgumentException

Parameters:

argValue - the argument value to check.

Throws:

java.lang.IllegalArgumentException - if the argument value is null.

checkCollectionNotEmpty

public static <T extends java.util.Collection<?>> T checkCollectionNotEmpty(T collection,
                                                                            java.lang.String errorMessage)

Ensures that a collection is not null or empty.

checkNullOrNotEmpty

public static java.lang.String checkNullOrNotEmpty(java.lang.String str,
                                                   java.lang.Object errorMessage)

Ensures that the string is either null, or a non-empty string.

checkNotEmpty

public static java.lang.String checkNotEmpty(java.lang.String str,
                                             java.lang.Object errorMessage)

Ensures that a string is not null or empty.

checkArgument

public static void checkArgument(boolean expression,
                                 java.lang.String errorTemplate,
                                 java.lang.Object... params)

readInputStream

public static java.lang.String readInputStream(java.io.InputStream in)
                                        throws java.io.IOException

Read a string from an input stream.

Throws:

java.io.IOException

closeQuietly

public static void closeQuietly(java.io.InputStream in)

Close an input stream quietly, i.e. without throwing an exception.

getThemePrimaryColor

public static int getThemePrimaryColor(android.content.Context context)

stringToSet

public static java.util.Set<java.lang.String> stringToSet(java.lang.String spaceDelimitedStr)

Converts the consolidated, space-delimited scope string to a set. If the supplied scope string is null, then null will be returned.

putIfNotNull

public static void putIfNotNull(org.json.JSONObject json,
                                java.lang.String field,
                                java.lang.String value)

Checks if json and field are non null and inserts into JSONObject.

Parameters:

json -

field -

value -

putIfNotNull

public static void putIfNotNull(org.json.JSONObject json,
                                java.lang.String field,
                                java.lang.Long value)

putIfNotNull

public static void putIfNotNull(org.json.JSONObject json,
                                java.lang.String field,
                                android.net.Uri value)

getStringIfDefined

public static java.lang.String getStringIfDefined(org.json.JSONObject json,
                                                  java.lang.String field)
                                           throws org.json.JSONException

Throws:

org.json.JSONException

getLongIfDefined

public static java.lang.Long getLongIfDefined(org.json.JSONObject json,
                                              java.lang.String field)
                                       throws org.json.JSONException

Throws:

org.json.JSONException

iterableToString

public static java.lang.String iterableToString(java.lang.Iterable<java.lang.String> strings)

put

public static void put(org.json.JSONObject json,
                       java.lang.String field,
                       org.json.JSONObject value)

Checks if json, field and value are non null and inserts into JSONObject.

Parameters:

json -

field -

value -

put

public static void put(org.json.JSONObject json,
                       java.lang.String field,
                       int value)

put

public static void put(org.json.JSONObject json,
                       java.lang.String field,
                       java.lang.String value)

put

public static void put(org.json.JSONObject json,
                       java.lang.String field,
                       org.json.JSONArray value)

getString

public static java.lang.String getString(org.json.JSONObject json,
                                         java.lang.String field)
                                  throws org.json.JSONException

Throws:

org.json.JSONException

getUriIfDefined

public static android.net.Uri getUriIfDefined(org.json.JSONObject json,
                                              java.lang.String field)
                                       throws org.json.JSONException

Throws:

org.json.JSONException

getTransformedResponse

public static java.util.Map<LiBrowse,java.util.List<LiBaseModel>> getTransformedResponse(java.util.List<LiBaseModel> response)

this method creates a Tree like structure depicting parent child relation for the Category and SubCategory in a community. //TODO right now it is hardcoded to LiBrowse and it should be generalized to use LiBaseModel

Parameters:

response -

Returns:

Map with Key as Parent node and vlaues as list of children.

getRawString

public static java.lang.String getRawString(android.content.Context context,
                                            int rawResId)

Computes default json as string from raw folder.

Parameters:

context -

rawResId -

Returns:

String is the raw file.

getTime

public static java.lang.Long getTime(java.lang.Long time)

sendLoginBroadcast

public static void sendLoginBroadcast(android.content.Context context,
                                      boolean isLoginSuccessful,
                                      int responseCode)

addLSIRequestHeaders

public static void addLSIRequestHeaders(android.content.Context context,
                                        Request.Builder builder)