com.box.androidsdk.content.utils

Class SdkUtils

java.lang.Object

com.box.androidsdk.content.utils.SdkUtils

public class SdkUtils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected static int[]	THUMB_COLORS
static long	TOAST_MIN_REPEAT_DELAY

Constructor Summary

Constructors

Constructor and Description
SdkUtils()

Method Summary

Modifier and Type	Method and Description
static int	calculateInSampleSize(android.graphics.BitmapFactory.Options options, int reqWidth, int reqHeight) Utility method to calculate the best sample size for downscaling Bitmap preserving aspect ratio.
static <T> T	cloneSerializable(T source) Helper method to clone a serializable object.
static void	closeQuietly(java.io.Closeable... closeables) Helper method to close one or more closeables while ignoring exceptions.
static java.lang.String	concatStringWithDelimiter(java.lang.String[] strings, java.lang.String delimiter) Utility method to create a large String with the given delimiter.
static java.lang.String	convertSerializableToString(java.io.Serializable obj) Helper method to write a serializable object into a String.
static void	copyStream(java.io.InputStream inputStream, java.io.OutputStream outputStream) Utility method to write given inputStream to given outputStream.
static java.io.OutputStream	createArrayOutputStream(java.io.OutputStream[] outputStreams) Helper method that wraps given arrays inside of a single outputstream.
static java.util.concurrent.ThreadPoolExecutor	createDefaultThreadPoolExecutor(int corePoolSize, int maximumPoolSize, long keepAliveTime, java.util.concurrent.TimeUnit unit) Utility method to create a new StringMappedThreadPoolExecutor (which can be used to inspect runnables).
static android.graphics.Bitmap	decodeSampledBitmapFromFile(java.io.File file, int reqWidth, int reqHeight) Utility method to create a downsampled bitmap from a given image file preserving aspect ratio.
static android.graphics.Bitmap	decodeSampledBitmapFromFile(android.content.res.Resources res, int resId, int reqWidth, int reqHeight) Utility method to create a downsampled bitmap from a given image file preserving aspect ratio.
static boolean	deleteFolderRecursive(java.io.File f) Recursively delete a folder and all its subfolders and files.
static java.lang.String	generateStateToken() Per OAuth2 specs, auth code exchange should include a state token for CSRF validation
static java.lang.String	getAssetFile(android.content.Context context, java.lang.String assetName) Helper method for reading an asset file into a string.
static java.lang.String	getAsStringSafely(java.lang.Object object) Helper method to return String form of an object that null checks.
static boolean	isBlank(java.lang.String str) Utility method to check if given string is blank.
static boolean	isEmptyString(java.lang.String str) Utility method to check if given string is empty.
static boolean	isInternetAvailable(android.content.Context context) Check for an internet connection.
static long	parseJsonValueToInteger(com.eclipsesource.json.JsonValue value) Parse a given JsonValue to an int regardless of whether that value is a String or an int.
static long	parseJsonValueToLong(com.eclipsesource.json.JsonValue value) Parse a given JsonValue to a long regardless of whether that value is a String or a long.
static void	setColorsThumb(android.widget.TextView initialsView, int position) Sets the the background thumb color for the account view to one of the material colors
static void	setInitialsThumb(android.content.Context context, android.widget.TextView initialsView, java.lang.String fullName) Helper method used to display initials into a given textview.
static java.lang.String	sha1(java.io.InputStream inputStream) Utilitiy method to calculate sha1 based on given inputStream.
static void	toastSafely(android.content.Context context, int resId, int duration) Helper method for showing a toast message checking to see if user is on ui thread, and not showing the same toast if it has already been shown within TOAST_MIN_REPEAT_DELAY time.

Methods inherited from class java.lang.Object

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

Field Detail

THUMB_COLORS

protected static final int[] THUMB_COLORS

TOAST_MIN_REPEAT_DELAY

public static long TOAST_MIN_REPEAT_DELAY

Constructor Detail

SdkUtils

public SdkUtils()

Method Detail

generateStateToken

public static java.lang.String generateStateToken()

Per OAuth2 specs, auth code exchange should include a state token for CSRF validation

Returns:

a randomly generated String to use as a state token

copyStream

public static void copyStream(java.io.InputStream inputStream,
                              java.io.OutputStream outputStream)
                       throws java.io.IOException,
                              java.lang.InterruptedException

Utility method to write given inputStream to given outputStream.

Parameters:

inputStream - the inputStream to copy from.

outputStream - the outputStream to write to.

Throws:

java.io.IOException - thrown if there was a problem reading from inputStream or writing to outputStream.

java.lang.InterruptedException - thrown if the thread is interrupted which indicates cancelling.

createArrayOutputStream

public static java.io.OutputStream createArrayOutputStream(java.io.OutputStream[] outputStreams)

Helper method that wraps given arrays inside of a single outputstream.

Parameters:

outputStreams - an array of multiple outputstreams.

Returns:

a single outputstream that will write to provided outputstreams.

getAsStringSafely

public static java.lang.String getAsStringSafely(java.lang.Object object)

Helper method to return String form of an object that null checks.

Parameters:

object - an object to get string from.

Returns:

String representation of object or null if object is null.

isEmptyString

public static boolean isEmptyString(java.lang.String str)

Utility method to check if given string is empty.

Parameters:

str - string to check.

Returns:

true if string provided is null or is of length 0.

isBlank

public static boolean isBlank(java.lang.String str)

Utility method to check if given string is blank.

Parameters:

str - string to check.

Returns:

true if string provided is null, is length 0, or consists of only spaces.

sha1

public static java.lang.String sha1(java.io.InputStream inputStream)
                             throws java.io.IOException,
                                    java.security.NoSuchAlgorithmException

Utilitiy method to calculate sha1 based on given inputStream.

Parameters:

inputStream - InputStream of file to calculate sha1 for.

Returns:

the calculated sha1 for given stream.

Throws:

java.io.IOException - thrown if there was issue getting stream content.

java.security.NoSuchAlgorithmException - thrown if Sha-1 algorithm implementation is not supported by OS.

parseJsonValueToLong

public static long parseJsonValueToLong(com.eclipsesource.json.JsonValue value)

Parse a given JsonValue to a long regardless of whether that value is a String or a long.

Parameters:

value - a JsonValue to parse to a long.

Returns:

a long representation of the given value. Can throw a runtime exception (ParseException, UnsupportedOperationException, or NumberFormatException).

parseJsonValueToInteger

public static long parseJsonValueToInteger(com.eclipsesource.json.JsonValue value)

Parse a given JsonValue to an int regardless of whether that value is a String or an int.

Parameters:

value - a JsonValue to parse to an int.

Returns:

an int representation of the given value. Can throw a runtime exception (ParseException, UnsupportedOperationException, or NumberFormatException).

concatStringWithDelimiter

public static java.lang.String concatStringWithDelimiter(java.lang.String[] strings,
                                                         java.lang.String delimiter)

Utility method to create a large String with the given delimiter.

Parameters:

strings - Strings to concatenate.

delimiter - The delimiter to use to put between each string item.

Returns:

a large string with all items separated by given delimiter.

createDefaultThreadPoolExecutor

public static java.util.concurrent.ThreadPoolExecutor createDefaultThreadPoolExecutor(int corePoolSize,
                                                                                      int maximumPoolSize,
                                                                                      long keepAliveTime,
                                                                                      java.util.concurrent.TimeUnit unit)

Utility method to create a new StringMappedThreadPoolExecutor (which can be used to inspect runnables).

Parameters:

corePoolSize - the number of threads to keep in the pool, even if they are idle, unless allowCoreThreadTimeOut is set

maximumPoolSize - the maximum number of threads to allow in the pool

keepAliveTime - when the number of threads is greater than the core, this is the maximum time that excess idle threads will wait for new tasks before terminating.

unit - the time unit for the keepAliveTime argument

Returns:

a StringMappedThreadPoolExecutor created from given arguments.

cloneSerializable

public static <T> T cloneSerializable(T source)

Helper method to clone a serializable object.

Type Parameters:

T - The class of the serializable object.

Parameters:

source - the serializable object to clone.

Returns:

a clone of the given source object.

convertSerializableToString

public static java.lang.String convertSerializableToString(java.io.Serializable obj)

Helper method to write a serializable object into a String.

Parameters:

obj - the Serializable object

Returns:

a String representation of obj.

closeQuietly

public static void closeQuietly(java.io.Closeable... closeables)

Helper method to close one or more closeables while ignoring exceptions.

Parameters:

closeables - one or more closeables to close while swallowing exceptions.

deleteFolderRecursive

public static boolean deleteFolderRecursive(java.io.File f)

Recursively delete a folder and all its subfolders and files.

Parameters:

f - directory to be deleted.

Returns:

True if the folder was deleted.

isInternetAvailable

public static boolean isInternetAvailable(android.content.Context context)

Check for an internet connection.

Parameters:

context - current context.

Returns:

whether or not there is a valid internet connection

getAssetFile

public static java.lang.String getAssetFile(android.content.Context context,
                                            java.lang.String assetName)

Helper method for reading an asset file into a string.

Parameters:

context - current context.

assetName - the asset name

Returns:

a string representation of a file in assets.

toastSafely

public static void toastSafely(android.content.Context context,
                               int resId,
                               int duration)

Helper method for showing a toast message checking to see if user is on ui thread, and not showing the same toast if it has already been shown within TOAST_MIN_REPEAT_DELAY time.

Parameters:

context - current context.

resId - string resource id to display.

duration - Toast.LENGTH_LONG or Toast.LENGTH_SHORT.

setInitialsThumb

public static void setInitialsThumb(android.content.Context context,
                                    android.widget.TextView initialsView,
                                    java.lang.String fullName)

Helper method used to display initials into a given textview.

Parameters:

context - current context

initialsView - TextView used to set initials into.

fullName - The user's full name to create initials for.

setColorsThumb

public static void setColorsThumb(android.widget.TextView initialsView,
                                  int position)

Sets the the background thumb color for the account view to one of the material colors

Parameters:

initialsView - view where the thumbs will be shown

position - index position of item

decodeSampledBitmapFromFile

public static android.graphics.Bitmap decodeSampledBitmapFromFile(android.content.res.Resources res,
                                                                  int resId,
                                                                  int reqWidth,
                                                                  int reqHeight)

Utility method to create a downsampled bitmap from a given image file preserving aspect ratio.

Parameters:

res - Resource to get asset from.

resId - the id of the image asset.

reqWidth - the required width for the bitmap

reqHeight - the required height for the bitmap.

Returns:

Bitmap from file that has been downsampled to fit width and height.

decodeSampledBitmapFromFile

public static android.graphics.Bitmap decodeSampledBitmapFromFile(java.io.File file,
                                                                  int reqWidth,
                                                                  int reqHeight)

Utility method to create a downsampled bitmap from a given image file preserving aspect ratio.

Parameters:

file - image file

reqWidth - the required width for the bitmap

reqHeight - the required height for the bitmap.

Returns:

Bitmap from file that has been downsampled to fit width and height.

calculateInSampleSize

public static int calculateInSampleSize(android.graphics.BitmapFactory.Options options,
                                        int reqWidth,
                                        int reqHeight)

Utility method to calculate the best sample size for downscaling Bitmap preserving aspect ratio.

Parameters:

options - BitmapFactory options of a Bitmap used to check dimensions.

reqWidth - the required width for displaying bitmap.

reqHeight - the required height for displaying the bitmap.

Returns:

an integer indicating best sample size to display Bitmap for the given dimensions.