com.cloudant.sync.util

Class Misc

java.lang.Object

com.cloudant.sync.util.Misc

public class Misc
extends java.lang.Object

Internal utility class

API Status: Private - API users are discouraged from using this class as fields, method signatures, and implementation details may be subject to change

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ANDROID_RUNTIME

Constructor Summary

Constructors

Constructor and Description
Misc()

Method Summary

Modifier and Type	Method and Description
static void	checkArgument(boolean argCondition, java.lang.String errorMessage) Check an argument meets a condition and throw an IllegalArgumentException if it doesn't.
static void	checkNotNull(java.lang.Object param, java.lang.String errorMessagePrefix) Check that a parameter is not null and throw IllegalArgumentException with a message of errorMessagePrefix + " must not be null." if it is null, defaulting to "Parameter must not be null.".
static void	checkNotNullOrEmpty(java.lang.String param, java.lang.String errorMessagePrefix) Check that a string parameter is not null or empty and throw IllegalArgumentException with a message of errorMessagePrefix + " must not be empty." if it is empty, defaulting to "Parameter must not be empty".
static void	checkState(boolean stateCheck, java.lang.String errorMessage) Check if a condition is true and throw an IllegalStateException with the given errorMessage if it is not.
static java.lang.String	createUUID()
static byte[]	getSha1(java.io.InputStream shaFis)
static boolean	isRunningOnAndroid()
static boolean	isStringNullOrEmpty(java.lang.String param)
static java.lang.String	join(java.lang.String separator, java.util.Collection<java.lang.String> stringsToJoin) Utility to join strings with a separator.

Methods inherited from class java.lang.Object

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

Field Detail

ANDROID_RUNTIME

public static final java.lang.String ANDROID_RUNTIME

See Also:

Constant Field Values

Constructor Detail

Misc

public Misc()

Method Detail

createUUID

public static java.lang.String createUUID()

isRunningOnAndroid

public static boolean isRunningOnAndroid()

getSha1

public static byte[] getSha1(java.io.InputStream shaFis)

join

public static java.lang.String join(java.lang.String separator,
                                    java.util.Collection<java.lang.String> stringsToJoin)

Utility to join strings with a separator. Skips null strings and does not append a trailing separator.

Parameters:

separator - the string to use to separate the entries

stringsToJoin - the strings to join together

Returns:

the joined string

checkNotNull

public static void checkNotNull(java.lang.Object param,
                                java.lang.String errorMessagePrefix)
                         throws java.lang.NullPointerException

Check that a parameter is not null and throw IllegalArgumentException with a message of errorMessagePrefix + " must not be null." if it is null, defaulting to "Parameter must not be null.".

Parameters:

param - the parameter to check

errorMessagePrefix - the prefix of the error message to use for the IllegalArgumentException if the parameter was null

Throws:

java.lang.NullPointerException - if the arg is null.

checkNotNullOrEmpty

public static void checkNotNullOrEmpty(java.lang.String param,
                                       java.lang.String errorMessagePrefix)
                                throws java.lang.IllegalArgumentException

Check that a string parameter is not null or empty and throw IllegalArgumentException with a message of errorMessagePrefix + " must not be empty." if it is empty, defaulting to "Parameter must not be empty".

Parameters:

param - the string to check

errorMessagePrefix - the prefix of the error message to use for the IllegalArgumentException if the parameter was null or empty

Throws:

java.lang.IllegalArgumentException - if the string is null or empty

isStringNullOrEmpty

public static boolean isStringNullOrEmpty(java.lang.String param)

Parameters:

param - the string to check

Returns:

true if the string is null or emtpy

checkArgument

public static void checkArgument(boolean argCondition,
                                 java.lang.String errorMessage)
                          throws java.lang.IllegalArgumentException

Check an argument meets a condition and throw an IllegalArgumentException if it doesn't.

Parameters:

argCondition - the condition to check

errorMessage - the error message to use in the IllegalArgumentException

Throws:

java.lang.IllegalArgumentException - if the argCondition is false

checkState

public static void checkState(boolean stateCheck,
                              java.lang.String errorMessage)
                       throws java.lang.IllegalStateException

Check if a condition is true and throw an IllegalStateException with the given errorMessage if it is not.

Parameters:

stateCheck - the state condition to check

errorMessage - the error string to add to the IllegalStateException

Throws:

java.lang.IllegalStateException - if the stateCheck is false