com.braze.support

Class StringUtils

java.lang.Object

com.braze.support.StringUtils

Direct Known Subclasses:

StringUtils

public class StringUtils
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	checkNotNullOrEmpty(java.lang.String reference)
static int	countOccurrences(java.lang.String reference, java.lang.String subString)
static java.lang.String	emptyToNull(java.lang.String input) ' If input is empty or only contains whitespace, returns null.
static long	getByteSize(java.lang.String value) Gets the number of bytes in UTF-8 encoding.
static java.lang.String	getCacheFileSuffix(android.content.Context context, java.lang.String userId) Gets a MD5 hash of the userId.
static java.lang.String	getCacheFileSuffix(android.content.Context context, java.lang.String userId, java.lang.String apiKey) There is the potential for having a too-long filename, but Android doesn't actually have anything about that in the docs.
static java.lang.String	getMd5Hash(java.lang.String text) Calculates the MD5 hash for some text.
static boolean	isBlank(java.lang.String reference) Checks if the string is empty or only contains whitespace characters.
static boolean	isNullOrBlank(java.lang.String reference) Checks if the string is null or only contains whitespace characters.
static boolean	isNullOrEmpty(java.lang.String reference) Checks if the string is null or has a length of 0.
static java.lang.String	join(java.util.Collection<java.lang.String> strings, java.lang.String sep)
static java.lang.String	join(java.lang.String[] strings, java.lang.String sep)
static java.util.HashSet<java.lang.String>	jsonArrayToHashSet(org.json.JSONArray jsonArray)
static java.lang.String	stringArrayToJsonString(java.lang.String[] stringArray)
static java.lang.String	truncateToByteLength(java.lang.String input, int byteLength) Truncates and returns the input text to the desired number of UTF-8 bytes.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

public StringUtils()

Method Detail

checkNotNullOrEmpty

public static java.lang.String checkNotNullOrEmpty(java.lang.String reference)

join

public static java.lang.String join(java.util.Collection<java.lang.String> strings,
                                    java.lang.String sep)

join

public static java.lang.String join(java.lang.String[] strings,
                                    java.lang.String sep)

Parameters:

strings - the list of strings to be joined

sep - a string to be used as a separator between joined strings

Returns:

a single string with all elements in the input string list joined together with sep as the separator. Null elements are skipped and not included in the output string. If the input string list or separator is null, returns the empty string.

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.String reference)

Checks if the string is null or has a length of 0.

isNullOrBlank

public static boolean isNullOrBlank(java.lang.String reference)

Checks if the string is null or only contains whitespace characters. This will call String.trim() to ascertain whether the string contains only whitespace.

isBlank

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

Checks if the string is empty or only contains whitespace characters. This will call String.trim() to ascertain whether the string contains only whitespace.

emptyToNull

public static java.lang.String emptyToNull(java.lang.String input)

' If input is empty or only contains whitespace, returns null. No null checking is performed.

countOccurrences

public static int countOccurrences(java.lang.String reference,
                                   java.lang.String subString)

jsonArrayToHashSet

public static java.util.HashSet<java.lang.String> jsonArrayToHashSet(org.json.JSONArray jsonArray)
                                                              throws org.json.JSONException

Throws:

org.json.JSONException

stringArrayToJsonString

public static java.lang.String stringArrayToJsonString(java.lang.String[] stringArray)

getCacheFileSuffix

public static java.lang.String getCacheFileSuffix(android.content.Context context,
                                                  java.lang.String userId,
                                                  java.lang.String apiKey)

There is the potential for having a too-long filename, but Android doesn't actually have anything about that in the docs. Stack overflow suggests < 127 characters, so with the API key 36 characters and 31 characters of prefix, that leaves 60 characters for userId. We'll use the MD5 hash to make sure it fits. For a speedup, we cache previous values of userId+apiKey to disk and retrieve them. This is all done to avoid a call to MessageDigest.getInstance when the sdk is being initialized. Note, the MD5 hash of the user id gets saved to disk, not the full suffix. This is because the apiKey is optional while the userId is not. In the prefs file, the userId is saved along with the hash of the id. I.e., the prefs file looks like this: USER_ID_KEY -> (the user id corresponding to the saved MD5 hash) USER_ID_HASH_VALUE -> (the hash of the aforementioned user id)

Parameters:

context - The application context used to read from a saved-on-disk store of user id hashes

userId - the user id used to generate a MD5 hash for the file name. If null, the string "null" gets used in its place before hashing.

apiKey - optional api key

getCacheFileSuffix

public static java.lang.String getCacheFileSuffix(android.content.Context context,
                                                  java.lang.String userId)

Gets a MD5 hash of the userId. If userId is null, a MD5 hash of the String "null" is returned.

getMd5Hash

public static java.lang.String getMd5Hash(java.lang.String text)

Calculates the MD5 hash for some text. See http://stackoverflow.com/questions/415953/how-can-i-generate-an-md5-hash/6565597#6565597

Parameters:

text - the text to be hashed

Returns:

the MD$ hash of the text or null if the hash cannot be computed.

getByteSize

public static long getByteSize(java.lang.String value)

Gets the number of bytes in UTF-8 encoding.

truncateToByteLength

public static java.lang.String truncateToByteLength(java.lang.String input,
                                                    int byteLength)

Truncates and returns the input text to the desired number of UTF-8 bytes.

Parameters:

input - The string to be truncated. May have multiple bytes per char.

byteLength - The desired length, in UTF-8 bytes, of the output string.

Returns:

The input string, truncated to the desired number of bytes in UTF-8.