org.pfsw.bif

Class BasicUtil

java.lang.Object

org.pfsw.bif.BasicUtil

public class BasicUtil
extends java.lang.Object

Basic utility methods that should actually be part of the JDK.

Field Summary

Fields

Modifier and Type	Field and Description
static BasicUtil	BU

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BasicUtil()

Method Summary

Modifier and Type	Method and Description
IExecutable	asExecutable(java.lang.Runnable runnable) Converts the given runnable into an IExecutable;
java.lang.Runnable	asRunnable(IExecutable executable) Converts the given executable into an Runnable;
java.lang.String	asString(java.lang.Object object) Returns the string representation of the given object utilizing either asString() if it implements IStringRepresentation, name() if it is an enum value or toString() for all other objects.
<T> CompareResult	compare(java.lang.Comparable<T> object1, T object2) Compares the first object to the second and returns an enum value for the result.
boolean	containsWhitespaceChars(java.lang.String str) Returns whether or not the given string contains any white space character.
static BasicUtil	current()
java.lang.Double	firstValidValue(java.lang.Double... values) Returns the first value of the given value array that is not NaN or null if none found.
java.lang.Float	firstValidValue(java.lang.Float... values) Returns the first value of the given value array that is not NaN or null if none found.
boolean	isAnyNull(java.lang.Object... objects) Returns true if the given array contains at least one null value.
boolean	isAnyNullOrBlank(java.lang.String... strings) Returns true if any one of the given strings is null or blank.
<T> boolean	isEqual(java.lang.Comparable<T> object1, T object2) Returns whether or not the first given object is equal to the second.
<T> boolean	isGreater(java.lang.Comparable<T> object1, T object2) Returns whether or not the first given object is greater than the second.
<T> boolean	isLess(java.lang.Comparable<T> object1, T object2) Returns whether or not the first given object is less than the second.
boolean	isNoneNull(java.lang.Object... objects) Returns true if the given array contains no null value.
boolean	isNoneNullOrBlank(java.lang.String... strings) Returns true if none of the given strings is null or blank.
boolean	isNullOrBlank(java.lang.String str) Returns true if the given string is null or empty or consists of whitespace characters only.
boolean	isNullOrEmpty(java.util.Collection<?> collection) Returns true if the given collection is null or has no elements.
boolean	isNullOrEmpty(java.util.Map<?,?> map) Returns true if the given map is null or has no elements.
boolean	isNullOrEmpty(java.lang.Object[] array) Returns true if the given array is null or has no elements.
boolean	isNullOrEmpty(java.lang.String str) Returns true if the given string is null or empty
boolean	isNullOrEmpty(java.lang.String[] strings) Returns true if the given string array is null or empty
boolean	isTypeOf(java.lang.Object object, java.lang.Class<?> type) Returns whether or not the given object is exactly of the specified type.
boolean	isTypeOrSubTypeOf(java.lang.Object object, java.lang.Class<?> type) Returns whether or not the given object is the same type as the specified type of a sub-type of this type.
static void	noop() This method is intentionally doing nothing at all.
boolean	notNullOrBlank(java.lang.String str) Returns true if the given string is not null and not empty and does not consist of whitespace characters only.
boolean	notNullOrEmpty(java.lang.String str) Returns true if the given string is not null and not empty.

Methods inherited from class java.lang.Object

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

Field Detail

BU

public static final BasicUtil BU

Constructor Detail

BasicUtil

protected BasicUtil()

Method Detail

current

public static BasicUtil current()

noop

public static void noop()

This method is intentionally doing nothing at all. It can be used in situations where a runnable callback is required that should do nothing.

isNoneNull

public boolean isNoneNull(java.lang.Object... objects)

Returns true if the given array contains no null value.

Parameters:

objects - The array to check (must not be null).

isAnyNull

public boolean isAnyNull(java.lang.Object... objects)

Returns true if the given array contains at least one null value.

Parameters:

objects - The array to check (must not be null).

isNullOrEmpty

public boolean isNullOrEmpty(java.util.Collection<?> collection)

Returns true if the given collection is null or has no elements.

Parameters:

collection - The collection to check

isNullOrEmpty

public boolean isNullOrEmpty(java.lang.Object[] array)

Returns true if the given array is null or has no elements.

Parameters:

array - The array to check

isNullOrEmpty

public boolean isNullOrEmpty(java.util.Map<?,?> map)

Returns true if the given map is null or has no elements.

Parameters:

map - The map to check

isAnyNullOrBlank

public boolean isAnyNullOrBlank(java.lang.String... strings)

Returns true if any one of the given strings is null or blank. Blanks means "" as well as strings filled with white spaces only (e.g. "\t ").

isNoneNullOrBlank

public boolean isNoneNullOrBlank(java.lang.String... strings)

Returns true if none of the given strings is null or blank. Blanks means "" as well as strings filled with white spaces only (e.g. "\t ").

isNullOrEmpty

public boolean isNullOrEmpty(java.lang.String[] strings)

Returns true if the given string array is null or empty

Parameters:

strings - The string array to check

isNullOrEmpty

public boolean isNullOrEmpty(java.lang.String str)

Returns true if the given string is null or empty

Parameters:

str - The string to check

isNullOrBlank

public boolean isNullOrBlank(java.lang.String str)

Returns true if the given string is null or empty or consists of whitespace characters only.

Parameters:

str - The string to check

notNullOrEmpty

public boolean notNullOrEmpty(java.lang.String str)

Returns true if the given string is not null and not empty.

Parameters:

str - The string to check.

notNullOrBlank

public boolean notNullOrBlank(java.lang.String str)

Returns true if the given string is not null and not empty and does not consist of whitespace characters only.

Parameters:

str - The string to check.

containsWhitespaceChars

public boolean containsWhitespaceChars(java.lang.String str)

Returns whether or not the given string contains any white space character. Returns false for null or empty string.

Parameters:

str - The string to check.

Returns:

true if the given string contains any white space character.

isLess

public <T> boolean isLess(java.lang.Comparable<T> object1,
                          T object2)

Returns whether or not the first given object is less than the second.

Parameters:

object1 - The object to be compared if it is less than the other object (must not be null).

object2 - The object to be compared with (must not be null).

Returns:

true if the first given object is less than the second.

isEqual

public <T> boolean isEqual(java.lang.Comparable<T> object1,
                           T object2)

Returns whether or not the first given object is equal to the second.

Parameters:

object1 - The object to be compared if it is equal to the other object (must not be null).

object2 - The object to be compared with (must not be null).

Returns:

true if the first given object is equal to the second.

isGreater

public <T> boolean isGreater(java.lang.Comparable<T> object1,
                             T object2)

Returns whether or not the first given object is greater than the second.

Parameters:

object1 - The object to be compared if it is greater than the other object (must not be null).

object2 - The object to be compared with (must not be null).

Returns:

true if the first given object is greater than the second.

compare

public <T> CompareResult compare(java.lang.Comparable<T> object1,
                                 T object2)

Compares the first object to the second and returns an enum value for the result.

Parameters:

object1 - The object to be compared to the other object (must not be null).

object2 - The object to be compared with (must not be null).

Returns:

The outcome of the comparison.

asString

public java.lang.String asString(java.lang.Object object)

Returns the string representation of the given object utilizing either asString() if it implements IStringRepresentation, name() if it is an enum value or toString() for all other objects.

Parameters:

object - The object to get the string representation for (may be null).

Returns:

Returns the string representation of the given object or null if it is null.

isTypeOf

public boolean isTypeOf(java.lang.Object object,
                        java.lang.Class<?> type)

Returns whether or not the given object is exactly of the specified type. This is more restrictive than instanceof checking because it ignores inheritance. Returns null if any of the arguments is null.

isTypeOrSubTypeOf

public boolean isTypeOrSubTypeOf(java.lang.Object object,
                                 java.lang.Class<?> type)

Returns whether or not the given object is the same type as the specified type of a sub-type of this type. Returns null if any of the arguments is null.

firstValidValue

public java.lang.Double firstValidValue(java.lang.Double... values)

Returns the first value of the given value array that is not NaN or null if none found.

firstValidValue

public java.lang.Float firstValidValue(java.lang.Float... values)

Returns the first value of the given value array that is not NaN or null if none found.

asExecutable

public IExecutable asExecutable(java.lang.Runnable runnable)

Converts the given runnable into an IExecutable;

asRunnable

public java.lang.Runnable asRunnable(IExecutable executable)

Converts the given executable into an Runnable;