org.whaka.util.reflection.comparison

Class ComparisonPerformers

java.lang.Object

org.whaka.util.reflection.comparison.ComparisonPerformers

public class ComparisonPerformers
extends java.lang.Object

Class provides entry-point to the performers package and easy-access for its elements.

Field Summary

Fields

Modifier and Type	Field and Description
static ComparisonPerformer<java.lang.Object>	DEEP_EQUALS Basic performer that performs Objects.deepEquals(Object, Object) and returns basic ComparisonResult.
static ComparisonPerformer<java.lang.Number>	DOUBLE_MATH_EQUALS Performer uses DoubleMath.equals(Double, Double) to compare any specified numbers as doubles.
static ReflectiveComparisonPerformer	REFLECTIVE_EQUALS Just a static access-instance of the ReflectiveComparisonPerformer that performs full-depth recursive reflective comparison by fields.

Method Summary

Modifier and Type	Method and Description
static <T> ArrayComparisonPerformer<T>	array(ComparisonPerformer<? super T> elementPerformer) Create instance of the special case performer wrapper to handle arrays.
static <T> GettersDynamicPerformerBuilder<T>	buildGetters(java.lang.Class<T> type) Create instance of the GettersDynamicPerformerBuilder that filters in only public methods and with field GettersDynamicPerformerBuilder.DEFAULT_METHODS added as excluding predicate.
static <T> PropertyDynamicPerformerBuilder<T>	buildProperties(java.lang.Class<T> type) Create instance of the PropertyDynamicPerformerBuilder.
static <T> ComparisonPerformer<T>	fromPredicate(java.util.function.BiPredicate<T,T> predicate) Create ComparisonPerformer that executes specified predicate and returns simple ComparisonResult
static <T> ListComparisonPerformer<T>	list(ComparisonPerformer<T> elementPerformer) Create instance of the special case performer wrapper to handle lists.
static <T> MapComparisonPerformer<T>	map(ComparisonPerformer<? super T> elementPerformer) Create instance of the special case performer wrapper to handle maps.
static <T> ComparisonResult	safePerform(T actual, T expected, ComparisonPerformer<? super T> performer) If execution of the specified performer will cause any exception - ComparisonFail will be returned.
static <T> SetComparisonPerformer<T>	set(ComparisonPerformer<? super T> elementPerformer) Create instance of the special case performer wrapper to handle collections.

Methods inherited from class java.lang.Object

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

Field Detail

DEEP_EQUALS

public static final ComparisonPerformer<java.lang.Object> DEEP_EQUALS

Basic performer that performs Objects.deepEquals(Object, Object) and returns basic ComparisonResult. Might be used as default fallback performer for recursive, or delegative functionality.

DOUBLE_MATH_EQUALS

public static final ComparisonPerformer<java.lang.Number> DOUBLE_MATH_EQUALS

Performer uses DoubleMath.equals(Double, Double) to compare any specified numbers as doubles.

REFLECTIVE_EQUALS

public static final ReflectiveComparisonPerformer REFLECTIVE_EQUALS

Just a static access-instance of the ReflectiveComparisonPerformer that performs full-depth recursive reflective comparison by fields.

Might be used without any restrictions.

Method Detail

fromPredicate

public static <T> ComparisonPerformer<T> fromPredicate(java.util.function.BiPredicate<T,T> predicate)

Create ComparisonPerformer that executes specified predicate and returns simple ComparisonResult

array

public static <T> ArrayComparisonPerformer<T> array(ComparisonPerformer<? super T> elementPerformer)

Create instance of the special case performer wrapper to handle arrays. It will compare array elements using specified delegate performer.

list

public static <T> ListComparisonPerformer<T> list(ComparisonPerformer<T> elementPerformer)

Create instance of the special case performer wrapper to handle lists. It will compare list elements using specified delegate performer.

set

public static <T> SetComparisonPerformer<T> set(ComparisonPerformer<? super T> elementPerformer)

Create instance of the special case performer wrapper to handle collections. It will compare collection elements using specified delegate performer.

map

public static <T> MapComparisonPerformer<T> map(ComparisonPerformer<? super T> elementPerformer)

Create instance of the special case performer wrapper to handle maps. It will compare map values using specified delegate performer.

buildProperties

public static <T> PropertyDynamicPerformerBuilder<T> buildProperties(java.lang.Class<T> type)

Create instance of the PropertyDynamicPerformerBuilder. No additional configuration is performed.

buildGetters

public static <T> GettersDynamicPerformerBuilder<T> buildGetters(java.lang.Class<T> type)

Create instance of the GettersDynamicPerformerBuilder that filters in only public methods and with field GettersDynamicPerformerBuilder.DEFAULT_METHODS added as excluding predicate.

Note: builder created by this method will already have a requirement filter for public methods, it means that any non-public method cannot be processed by it! Use constructor manually to create a builder with different configuration.

Note: builder created by this method will already contain one excluding filter, and it will exclude all 'default' getters from the Object class.

safePerform

public static <T> ComparisonResult safePerform(T actual,
                                               T expected,
                                               ComparisonPerformer<? super T> performer)

If execution of the specified performer will cause any exception - ComparisonFail will be returned. Method guaranteed to not throw any exceptions, unless specified performer is null.