Package com.thanlinardos.spring_enterprise_library.objects.utils

Class ObjectUtils

java.lang.Object

com.thanlinardos.spring_enterprise_library.objects.utils.ObjectUtils

public class ObjectUtils
extends Object

Utility class for object-related operations.

Constructor Summary

Constructors

Constructor	Description
ObjectUtils()

Method Summary

Modifier and Type	Method	Description
static <A, B, C> Optional<C>	applyIfBothNotNull(A a, B b, BiFunction<A,B,C> merger)	Apply the given merger BiFunction on two given parameters, if both parameters a and b are not null.
static boolean	evaluateAllTrue(Supplier<Boolean>... suppliers)	Evaluates all the suppliers if needed and if all returns true then it returns true.
static boolean	evaluateAnyTrue(Supplier<Boolean>... suppliers)	Evaluates any of the suppliers if needed and if any of them is true, returns true.
static <T extends BasicIdJpa> String	getCommaSeparatedListOfIds(Collection<T> entities)	Returns a concatenated comma separated list of ids from the entities.
static <T> String	getDebugString(Collection<T> entities)	Returns useful debugging information like class, id, and toString representation.
static <T> String	getDebugString(T entity)	Returns useful debugging information like class, id, and toString representation.
static <T> Optional<T>	getFirstNonNull(Supplier<T>... suppliers)	Returns the first non-null element found by evaluating the suppliers.
static <T> Optional<T>	getFirstPresent(Supplier<Optional<T>>... suppliers)	Returns the first present optional element found by evaluating the suppliers.
static Long	getIdOrNull(BasicIdJpa entity)	Returns the id of the entity, otherwise null.
static <T extends BasicIdJpa> Set<Long>	getIds(Collection<T> entities)	Returns a set of ids of the entities
static <T, R> R	getOrNull(T object, Function<T,R> getter)	Returns the value extracted by the getter from the object if the object is not null, otherwise returns null.
static boolean	isAllObjectsEquals(Object object, Object... objects)	Returns true if all the objects supplied are equal.
static boolean	isAllObjectsNotNull(Object object, Object... objects)	Returns true if all the objects supplied are not null.
static boolean	isAllObjectsNotNullAndEquals(Object object, Object... objects)	Returns true if all the objects supplied are not null and are all equal.
static boolean	isAllObjectsNull(Object object, Object... objects)	Returns true if all the objects supplied are null.
static boolean	isAnyObjectNotNull(Object object, Object... objects)	Returns true if any of the objects supplied are not null.
static boolean	isAnyObjectNull(Object object, Object... objects)	Returns true if any of the objects supplied are null.

Methods inherited from class java.lang.Object

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

Constructor Details

ObjectUtils

public ObjectUtils()

Method Details

isAnyObjectNull

public static boolean isAnyObjectNull(Object object,
 Object... objects)

Returns true if any of the objects supplied are null.

Parameters:

object - the first object to check for null.

objects - the objects to check for null.

Returns:

true if any of the objects are null

isAnyObjectNotNull

public static boolean isAnyObjectNotNull(Object object,
 Object... objects)

Returns true if any of the objects supplied are not null.

Parameters:

object - the first object to check for null.

objects - the objects to check for null.

Returns:

true if any of the objects are not null.

isAllObjectsNull

public static boolean isAllObjectsNull(Object object,
 Object... objects)

Returns true if all the objects supplied are null.

Parameters:

object - the first object to check for null.

objects - the objects to check for null

Returns:

true if all the objects are null, otherwise false.

isAllObjectsNotNull

public static boolean isAllObjectsNotNull(Object object,
 Object... objects)

Returns true if all the objects supplied are not null.

Parameters:

object - the first object to check for null.

objects - the objects to check for null

Returns:

true if all the objects are not null, otherwise false.

isAllObjectsEquals

public static boolean isAllObjectsEquals(Object object,
 Object... objects)

Returns true if all the objects supplied are equal.

Parameters:

object - the first object to check for equals.

objects - the objects to check for equals.

Returns:

true if all the objects supplied are equal.

isAllObjectsNotNullAndEquals

public static boolean isAllObjectsNotNullAndEquals(Object object,
 Object... objects)

Returns true if all the objects supplied are not null and are all equal.

Parameters:

object - the first object to check for null and equals.

objects - the objects to check for null and equals.

Returns:

true if all the objects supplied are not null and are all equal.

evaluateAllTrue

@SafeVarargs
public static boolean evaluateAllTrue(Supplier<Boolean>... suppliers)

Evaluates all the suppliers if needed and if all returns true then it returns true. It uses noneMatch which is a short-circuiting operation to skip evaluating the rest if one is false.

Parameters:

suppliers - the suppliers to evaluate

Returns:

true if all suppliers evaluates to true, otherwise false.

evaluateAnyTrue

@SafeVarargs
public static boolean evaluateAnyTrue(Supplier<Boolean>... suppliers)

Evaluates any of the suppliers if needed and if any of them is true, returns true. It uses anyMatch which is a short-circuiting operation to skip evaluating the rest if one is true.

Parameters:

suppliers - the suppliers to evaluate

Returns:

true if any suppliers evaluates to true, otherwise false.

getFirstNonNull

@SafeVarargs
public static <T> Optional<T> getFirstNonNull(Supplier<T>... suppliers)

Returns the first non-null element found by evaluating the suppliers. It uses findFirst which is a short-circuiting operation to only evaluate enough suppliers to get the first non-null.

Type Parameters:

T - the type class of the elements.

Parameters:

suppliers - the suppliers to possibly evaluate

Returns:

first non-null element found as an optional, otherwise empty optional.

getFirstPresent

@SafeVarargs
public static <T> Optional<T> getFirstPresent(Supplier<Optional<T>>... suppliers)

Returns the first present optional element found by evaluating the suppliers. It uses findFirst which is a short-circuiting operation to only evaluate enough suppliers to get the first present.

Type Parameters:

T - the type class of the elements.

Parameters:

suppliers - the suppliers to possibly evaluate.

Returns:

The first present element found, otherwise empty optional.

getOrNull

public static <T,
R> R getOrNull(@Nullable
 T object,
 Function<T,R> getter)

Returns the value extracted by the getter from the object if the object is not null, otherwise returns null.

Type Parameters:

T - the type class of the given object

R - the type class of the extracted value

Parameters:

object - The object

getter - The getter

Returns:

the value extracted by the getter from the object if the object is not null, otherwise null.

getIdOrNull

public static Long getIdOrNull(BasicIdJpa entity)

Returns the id of the entity, otherwise null.

Parameters:

entity - the entity.

Returns:

the id of the entity, otherwise null.

getCommaSeparatedListOfIds

public static <T extends BasicIdJpa> String getCommaSeparatedListOfIds(Collection<T> entities)

Returns a concatenated comma separated list of ids from the entities.

Type Parameters:

T - the type class of the given entities.

Parameters:

entities - the entities.

Returns:

a concatenated comma separated list of ids from the entities.

getIds

public static <T extends BasicIdJpa> Set<Long> getIds(Collection<T> entities)

Returns a set of ids of the entities

Type Parameters:

T - the type class of the given entities.

Parameters:

entities - the entities

Returns:

a set of ids of the entities

getDebugString

public static <T> String getDebugString(Collection<T> entities)

Returns useful debugging information like class, id, and toString representation.

Type Parameters:

T - type of the entities

Parameters:

entities - the entities

Returns:

a string describing the entities

getDebugString

public static <T> String getDebugString(@Nullable
 T entity)

Returns useful debugging information like class, id, and toString representation.

Type Parameters:

T - type of the entity

Parameters:

entity - the entity

Returns:

a string describing the entity

applyIfBothNotNull

public static <A,
B,
C> Optional<C> applyIfBothNotNull(@Nullable
 A a,
 @Nullable
 B b,
 BiFunction<A,B,C> merger)

Apply the given merger BiFunction on two given parameters, if both parameters a and b are not null. Returns the result of the merger wrapped in an Optional, otherwise it will return Optional.empty(). If the merger returns an Optional as well, then apply:

.flatMap(Function.identity())

to the result of this method.

Type Parameters:

A - the type of the first parameter.

B - the type of the second parameter.

C - the result type.

Parameters:

a - first parameter

b - second parameter

merger - a method that takes two objects with types A and B, and returns a result with type C

Returns:

an optional containing the result of the merger method if both input parameters are not null, otherwise Optional.empty().