Class RecursiveComparisonConfiguration
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final class
Builder to buildRecursiveComparisonConfiguration
. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate Set<FieldLocation>
private static final String
private static final boolean
private FieldComparators
private FieldMessages
private boolean
private boolean
private boolean
private boolean
private boolean
static final String
private boolean
private TypeComparators
private TypeMessages
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprivate
-
Method Summary
Modifier and TypeMethodDescriptionprivate static Class<?>
asWrapperIfPrimitiveType
(Class<?> type) builder()
Creates builder to buildRecursiveComparisonConfiguration
.Stream<Map.Entry<String,
Comparator<?>>> (package private) Stream<Map.Entry<Class<?>,
Comparator<?>>> void
compareOnlyFields
(String... fieldNamesToCompare) Adds the given fields and their subfields to the set of fields from the object under test to compare (no other fields will be compared).private void
describeComparatorForFields
(StringBuilder description) private void
describeComparatorForTypes
(StringBuilder description) private String
private void
describeComparedFields
(StringBuilder description) private void
describeErrorMessagesForFields
(StringBuilder description) private void
describeErrorMessagesForType
(StringBuilder description) private void
describeIgnoreAllActualEmptyOptionalFields
(StringBuilder description) private void
describeIgnoreAllActualNullFields
(StringBuilder description) private void
describeIgnoreAllExpectedNullFields
(StringBuilder description) private void
describeIgnoreCollectionOrder
(StringBuilder description) private String
private void
describeIgnoredCollectionOrderInFields
(StringBuilder description) private void
private String
private void
describeIgnoredFields
(StringBuilder description) private void
describeIgnoredFieldsForTypes
(StringBuilder description) private void
describeIgnoredFieldsRegexes
(StringBuilder description) private String
private String
describeIgnoredOverriddenEqualsForTypes
(Representation representation) private void
describeIgnoredOverriddenEqualsMethods
(StringBuilder description, Representation representation) private String
private void
describeOverriddenEqualsMethodsUsage
(StringBuilder description, Representation representation) private String
describeRegexes
(List<Pattern> regexes) private void
describeRegisteredComparatorByTypes
(StringBuilder description) private void
describeRegisteredComparatorForFields
(StringBuilder description) private void
describeRegisteredErrorMessagesForFields
(StringBuilder description) private void
describeRegisteredErrorMessagesForTypes
(StringBuilder description) private void
describeTypeCheckingStrictness
(StringBuilder description) private static DualValue
dualValueForField
(DualValue parentDualValue, String fieldName) boolean
private String
formatRegisteredComparatorByType
(Map.Entry<Class<?>, Comparator<?>> next) private String
formatRegisteredComparatorForField
(Map.Entry<String, Comparator<?>> comparatorForField) getActualFieldNamesToCompare
(DualValue dualValue) Comparator<?>
getComparatorForField
(String fieldName) Comparator<?>
getComparatorForType
(Class<?> fieldType) Returns the set of fields to compare from the object under test (no other fields will be compared).(package private) boolean
(package private) boolean
(package private) boolean
(package private) boolean
(package private) boolean
Returns the list fields from the object under test to ignore collection order in the recursive comparison.Returns the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.Returns the set of fields from the object under test to ignore in the recursive comparison.Returns the set of fields from the object under test types to ignore in the recursive comparison.getMessageForField
(String fieldName) getMessageForType
(Class<?> fieldType) boolean
hasComparatorForField
(String fieldName) boolean
hasComparatorForType
(Class<?> keyType) (package private) boolean
hasCustomComparator
(DualValue dualValue) boolean
boolean
hasCustomMessageForField
(String fieldName) boolean
hasCustomMessageForType
(Class<?> fieldType) int
hashCode()
void
Force a recursive comparison on all fields (except java types).void
ignoreCollectionOrder
(boolean ignoreCollectionOrder) Sets whether to ignore collection order in the comparison.void
ignoreCollectionOrderInFields
(String... fieldsToIgnoreCollectionOrder) Adds the given fields to the list fields from the object under test to ignore collection order in the recursive comparison.void
ignoreCollectionOrderInFieldsMatchingRegexes
(String... regexes) Adds the given regexes to the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.void
ignoreFields
(String... fieldsToIgnore) Adds the given fields to the set of fields from the object under test to ignore in the recursive comparison.void
ignoreFieldsMatchingRegexes
(String... regexes) Allows to ignore in the recursive comparison the object under test fields matching the given regexes.void
ignoreFieldsOfTypes
(Class<?>... types) Adds the given types to the list fields from the object under test types to ignore in the recursive comparison.void
ignoreOverriddenEqualsForFields
(String... fields) Adds the given fields to the list of fields to force a recursive comparison on.void
ignoreOverriddenEqualsForFieldsMatchingRegexes
(String... regexes) Adds the given regexes to the list of regexes used find the fields to force a recursive comparison on.void
ignoreOverriddenEqualsForTypes
(Class<?>... types) Adds the given types to the list of types to force a recursive comparison on.private boolean
boolean
private static String
join
(Collection<String> typesDescription) private boolean
matchesAnIgnoredCollectionOrderInField
(FieldLocation fieldLocation) private boolean
matchesAnIgnoredCollectionOrderInFieldRegex
(FieldLocation fieldLocation) private boolean
matchesAnIgnoredEmptyOptionalField
(DualValue dualValue) private boolean
matchesAnIgnoredField
(FieldLocation fieldLocation) private boolean
matchesAnIgnoredFieldRegex
(FieldLocation fieldLocation) private boolean
matchesAnIgnoredFieldType
(DualValue dualValue) private boolean
matchesAnIgnoredNullField
(DualValue dualValue) private boolean
matchesAnIgnoredOverriddenEqualsField
(FieldLocation fieldLocation) private boolean
matchesAnIgnoredOverriddenEqualsRegex
(Class<?> clazz) private boolean
matchesAnIgnoredOverriddenEqualsType
(Class<?> clazz) private static Predicate<FieldLocation>
multiLineDescription
(Representation representation) void
registerComparatorForFields
(Comparator<?> comparator, String... fieldLocations) Registers the givenComparator
to compare the fields at the given locations.<T> void
registerComparatorForType
(Comparator<? super T> comparator, Class<T> type) Registers the givenComparator
to compare the fields with the given type.void
registerEqualsForFields
(BiPredicate<?, ?> equals, String... fieldLocations) Registers the givenBiPredicate
to compare the fields at the given locations.<T> void
registerEqualsForType
(BiPredicate<? super T, ? super T> equals, Class<T> type) Registers the givenBiPredicate
to compare the fields with the given type.void
registerErrorMessageForFields
(String message, String... fieldLocations) Registers the giving message which would be shown when differences in the given fields while comparison occurred.void
registerErrorMessageForType
(String message, Class<?> clazz) Registers the giving message which would be shown when differences for the giving type while comparison occurred.void
setIgnoreAllActualEmptyOptionalFields
(boolean ignoringAllActualEmptyOptionalFields) Sets whether actual empty optional fields are ignored in the recursive comparison.void
setIgnoreAllActualNullFields
(boolean ignoreAllActualNullFields) Sets whether actual null fields are ignored in the recursive comparison.void
setIgnoreAllExpectedNullFields
(boolean ignoreAllExpectedNullFields) Sets whether expected null fields are ignored in the recursive comparison.private boolean
shouldBeCompared
(FieldLocation fieldLocation) (package private) boolean
shouldIgnore
(DualValue dualValue) (package private) boolean
shouldIgnoreCollectionOrder
(FieldLocation fieldLocation) private boolean
shouldIgnoreFieldBasedOnFieldLocation
(FieldLocation fieldLocation) private boolean
shouldIgnoreFieldBasedOnFieldValue
(DualValue dualValue) (package private) boolean
shouldIgnoreOverriddenEqualsOf
(Class<?> clazz) (package private) boolean
shouldIgnoreOverriddenEqualsOf
(DualValue dualValue) void
strictTypeChecking
(boolean strictTypeChecking) Sets whether the recursive comparison will check that actual's type is compatible with expected's type (the same applies for each field).private static Comparator
toComparator
(BiPredicate equals) toString()
void
Force a recursive comparison on all fields (except java types).
-
Field Details
-
DEFAULT_DELIMITER
- See Also:
-
DEFAULT_IGNORE_ALL_OVERRIDDEN_EQUALS
private static final boolean DEFAULT_IGNORE_ALL_OVERRIDDEN_EQUALS- See Also:
-
INDENT_LEVEL_2
- See Also:
-
strictTypeChecking
private boolean strictTypeChecking -
ignoreAllActualNullFields
private boolean ignoreAllActualNullFields -
ignoreAllActualEmptyOptionalFields
private boolean ignoreAllActualEmptyOptionalFields -
ignoreAllExpectedNullFields
private boolean ignoreAllExpectedNullFields -
ignoredFields
-
ignoredFieldsRegexes
-
ignoredTypes
-
comparedFields
-
ignoredOverriddenEqualsForTypes
-
ignoredOverriddenEqualsForFields
-
ignoredOverriddenEqualsForFieldsMatchingRegexes
-
ignoreAllOverriddenEquals
private boolean ignoreAllOverriddenEquals -
ignoreCollectionOrder
private boolean ignoreCollectionOrder -
ignoredCollectionOrderInFields
-
ignoredCollectionOrderInFieldsMatchingRegexes
-
typeComparators
-
fieldComparators
-
typeMessages
-
fieldMessages
-
-
Constructor Details
-
RecursiveComparisonConfiguration
-
RecursiveComparisonConfiguration
public RecursiveComparisonConfiguration()
-
-
Method Details
-
hasComparatorForField
-
getComparatorForField
-
hasCustomMessageForField
-
getMessageForField
-
getFieldComparators
-
hasComparatorForType
-
hasCustomComparators
public boolean hasCustomComparators() -
getComparatorForType
-
hasCustomMessageForType
-
getMessageForType
-
getTypeComparators
-
comparatorByTypes
Stream<Map.Entry<Class<?>,Comparator<?>>> comparatorByTypes() -
getIgnoreAllActualNullFields
boolean getIgnoreAllActualNullFields() -
getIgnoreAllExpectedNullFields
boolean getIgnoreAllExpectedNullFields() -
getIgnoreAllOverriddenEquals
boolean getIgnoreAllOverriddenEquals() -
setIgnoreAllActualEmptyOptionalFields
public void setIgnoreAllActualEmptyOptionalFields(boolean ignoringAllActualEmptyOptionalFields) Sets whether actual empty optional fields are ignored in the recursive comparison.See
RecursiveComparisonAssert.ignoringActualNullFields()
for code examples.- Parameters:
ignoringAllActualEmptyOptionalFields
- whether to ignore actual empty optional fields in the recursive comparison
-
getIgnoreAllActualEmptyOptionalFields
boolean getIgnoreAllActualEmptyOptionalFields() -
setIgnoreAllActualNullFields
public void setIgnoreAllActualNullFields(boolean ignoreAllActualNullFields) Sets whether actual null fields are ignored in the recursive comparison.See
RecursiveComparisonAssert.ignoringActualNullFields()
for code examples.- Parameters:
ignoreAllActualNullFields
- whether to ignore actual null fields in the recursive comparison
-
setIgnoreAllExpectedNullFields
public void setIgnoreAllExpectedNullFields(boolean ignoreAllExpectedNullFields) Sets whether expected null fields are ignored in the recursive comparison.See
RecursiveComparisonAssert.ignoringExpectedNullFields()
for code examples.- Parameters:
ignoreAllExpectedNullFields
- whether to ignore expected null fields in the recursive comparison
-
ignoreFields
Adds the given fields to the set of fields from the object under test to ignore in the recursive comparison.The fields are ignored by name, not by value.
See
RecursiveComparisonAssert#ignoringFields(String...)
for examples.- Parameters:
fieldsToIgnore
- the fields of the object under test to ignore in the comparison.
-
compareOnlyFields
Adds the given fields and their subfields to the set of fields from the object under test to compare (no other fields will be compared).The fields are specified by name, not by value, you can specify
person.name
but not"Jack"
as"Jack"
is not a field value.Specifying a field will make all its subfields to be compared, for example specifying
person
will lead to compareperson.name
,person.address
... on the other hand if you specifyperson.name
,person
won't be compared butperson.name
will be.See
RecursiveComparisonAssert#comparingOnlyFields(String...)
for examples.- Parameters:
fieldNamesToCompare
- the fields of the object under test to compare in the comparison.
-
ignoreFieldsMatchingRegexes
Allows to ignore in the recursive comparison the object under test fields matching the given regexes. The given regexes are added to the already registered ones.See
RecursiveComparisonAssert#ignoringFieldsMatchingRegexes(String...)
for examples.- Parameters:
regexes
- regexes used to ignore fields in the comparison.
-
ignoreFieldsOfTypes
Adds the given types to the list fields from the object under test types to ignore in the recursive comparison. The fields are ignored if their types exactly match one of the ignored types, if a field is a subtype of an ignored type it won't be ignored.Note that if some object under test fields are null, they are not ignored by this method as their type can't be evaluated.
See
RecursiveComparisonAssert#ignoringFieldsOfTypes(Class...)
for examples.- Parameters:
types
- the types of the object under test to ignore in the comparison.
-
asWrapperIfPrimitiveType
-
getIgnoredFields
Returns the set of fields from the object under test to ignore in the recursive comparison.- Returns:
- the set of fields from the object under test to ignore in the recursive comparison.
-
getComparedFields
Returns the set of fields to compare from the object under test (no other fields will be compared).- Returns:
- the set of fields from the object under test to compare.
-
getIgnoredTypes
Returns the set of fields from the object under test types to ignore in the recursive comparison.- Returns:
- the set of fields from the object under test types to ignore in the recursive comparison.
-
ignoreAllOverriddenEquals
public void ignoreAllOverriddenEquals()Force a recursive comparison on all fields (except java types).See
RecursiveComparisonAssert.ignoringAllOverriddenEquals()
for examples. -
useOverriddenEquals
public void useOverriddenEquals()Force a recursive comparison on all fields (except java types).See
RecursiveComparisonAssert.usingOverriddenEquals()
for examples. -
ignoreOverriddenEqualsForFields
Adds the given fields to the list of fields to force a recursive comparison on.See
RecursiveComparisonAssert#ignoringOverriddenEqualsForFields(String...)
for examples.- Parameters:
fields
- the fields to force a recursive comparison on.
-
ignoreOverriddenEqualsForFieldsMatchingRegexes
Adds the given regexes to the list of regexes used find the fields to force a recursive comparison on.See
RecursiveComparisonAssert#ignoringOverriddenEqualsForFieldsMatchingRegexes(String...)
for examples.- Parameters:
regexes
- regexes used to specify the fields we want to force a recursive comparison on.
-
ignoreOverriddenEqualsForTypes
Adds the given types to the list of types to force a recursive comparison on.See
RecursiveComparisonAssert#ignoringOverriddenEqualsForTypes(Class...)
for examples.- Parameters:
types
- the types to the list of types to force a recursive comparison on.
-
getIgnoreCollectionOrder
boolean getIgnoreCollectionOrder() -
ignoreCollectionOrder
public void ignoreCollectionOrder(boolean ignoreCollectionOrder) Sets whether to ignore collection order in the comparison.See
RecursiveComparisonAssert.ignoringCollectionOrder()
for code examples.- Parameters:
ignoreCollectionOrder
- whether to ignore collection order in the comparison.
-
ignoreCollectionOrderInFields
Adds the given fields to the list fields from the object under test to ignore collection order in the recursive comparison.See
RecursiveComparisonAssert#ignoringCollectionOrderInFields(String...)
for examples.- Parameters:
fieldsToIgnoreCollectionOrder
- the fields of the object under test to ignore collection order in the comparison.
-
getIgnoredCollectionOrderInFields
Returns the list fields from the object under test to ignore collection order in the recursive comparison.- Returns:
- the list fields from the object under test to ignore collection order in the recursive comparison.
-
ignoreCollectionOrderInFieldsMatchingRegexes
Adds the given regexes to the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.See
RecursiveComparisonAssert#ignoringCollectionOrderInFieldsMatchingRegexes(String...)
for examples.- Parameters:
regexes
- regexes used to find the object under test fields to ignore collection order in in the comparison.
-
getIgnoredCollectionOrderInFieldsMatchingRegexes
Returns the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.- Returns:
- the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.
-
registerComparatorForType
Registers the givenComparator
to compare the fields with the given type.Comparators registered with this method have less precedence than comparators registered with
registerComparatorForFields(Comparator, String...)
.Note that registering a
Comparator
for a given type will override the previously registered BiPredicate/Comparator (if any).See
RecursiveComparisonAssert.withComparatorForType(Comparator, Class)
for examples.- Type Parameters:
T
- the class type to register a comparator for- Parameters:
comparator
- theComparator
to use to compare the given typetype
- the type to be compared with the given comparator.- Throws:
NullPointerException
- if the given comparator is null.
-
registerEqualsForType
Registers the givenBiPredicate
to compare the fields with the given type.BiPredicates specified with this method have less precedence than the ones registered with
registerEqualsForFields(BiPredicate, String...)
or comparators registered withregisterComparatorForFields(Comparator, String...)
.Note that registering a
BiPredicate
for a given type will override the previously registered BiPredicate/Comparator (if any).See
RecursiveComparisonAssert.withEqualsForType(BiPredicate, Class)
for examples.- Type Parameters:
T
- the class type to register a comparator for- Parameters:
equals
- the equals implementation to compare the given typetype
- the type to be compared with the given equals implementation .- Throws:
NullPointerException
- if the given BiPredicate is null.- Since:
- 3.17.0
-
registerComparatorForFields
Registers the givenComparator
to compare the fields at the given locations.The fields must be specified from the root object, for example if
Foo
has aBar
field and both have anid
field, one can register a comparator for Foo and Bar'sid
by calling:registerComparatorForFields(idComparator, "foo.id", "foo.bar.id")
Comparators registered with this method have precedence over comparators registered with
registerComparatorForType(Comparator, Class)
.Note that registering a
Comparator
for a given field will override the previously registered BiPredicate/Comparator (if any).See
RecursiveComparisonAssert#withComparatorForFields(Comparator, String...)
for examples.- Parameters:
comparator
- theComparator
to use to compare the given fieldfieldLocations
- the locations from the root object of the fields the comparator should be used for- Throws:
NullPointerException
- if the given comparator is null.
-
registerEqualsForFields
Registers the givenBiPredicate
to compare the fields at the given locations.The fields must be specified from the root object, for example if
Foo
has aBar
field and both have anid
field, one can register a BiPredicate for Foo and Bar'sid
by calling:registerEqualsForFields(idBiPredicate, "foo.id", "foo.bar.id")
BiPredicates registered with this method have precedence over the ones registered with
registerEqualsForType(BiPredicate, Class)
or the comparators registered withregisterComparatorForType(Comparator, Class)
.Note that registering a
BiPredicate
for a given field will override the previously registered BiPredicate/Comparator (if any).See
RecursiveComparisonAssert#withEqualsForFields(BiPredicate, String...)
for examples.- Parameters:
equals
- the equals implementation to compare the given fields.fieldLocations
- the locations from the root object of the fields the comparator should be used for- Throws:
NullPointerException
- if the given BiPredicate is null.- Since:
- 3.17.0
-
registerErrorMessageForFields
Registers the giving message which would be shown when differences in the given fields while comparison occurred.The fields must be specified from the root object, for example if
Foo
has aBar
field and both have anid
field, one can register a message for Foo and Bar'sid
by calling:registerErrorMessageForFields("some message", "foo.id", "foo.bar.id")
Messages registered with this method have precedence over the ones registered with
registerErrorMessageForType(String, Class)
.In case of
null
as message the default error message will be used (SeeComparisonDifference.DEFAULT_TEMPLATE
).- Parameters:
message
- the error message that will be thrown when comparison error occurredfieldLocations
- the field locations the error message should be used for
-
registerErrorMessageForType
Registers the giving message which would be shown when differences for the giving type while comparison occurred.Message registered with this method have less precedence than the ones registered with
registerErrorMessageForFields(String, String...)
.In case of
null
as message the default error message will be used (SeeComparisonDifference.DEFAULT_TEMPLATE
).- Parameters:
message
- the error message that will be thrown when comparison error occurredclazz
- the type the error message should be used for
-
strictTypeChecking
public void strictTypeChecking(boolean strictTypeChecking) Sets whether the recursive comparison will check that actual's type is compatible with expected's type (the same applies for each field). Compatible means that the expected's type is the same or a subclass of actual's type.See
RecursiveComparisonAssert.withStrictTypeChecking()
for code examples.- Parameters:
strictTypeChecking
- whether the recursive comparison will check that actual's type is compatible with expected's type.
-
isInStrictTypeCheckingMode
public boolean isInStrictTypeCheckingMode() -
getIgnoredFieldsRegexes
-
getIgnoredOverriddenEqualsForTypes
-
getIgnoredOverriddenEqualsForFields
-
getIgnoredOverriddenEqualsForFieldsMatchingRegexes
-
comparatorByFields
-
toString
-
hashCode
public int hashCode() -
equals
-
multiLineDescription
-
shouldIgnore
-
shouldBeCompared
-
matchesComparedField
-
getActualFieldNamesToCompare
-
shouldIgnoreFieldBasedOnFieldValue
-
shouldIgnoreFieldBasedOnFieldLocation
-
dualValueForField
-
hasCustomComparator
-
shouldIgnoreOverriddenEqualsOf
-
shouldIgnoreOverriddenEqualsOf
-
shouldIgnoreCollectionOrder
-
describeIgnoredFieldsRegexes
-
describeIgnoredFields
-
describeComparedFields
-
describeIgnoredFieldsForTypes
-
describeIgnoreAllActualNullFields
-
describeIgnoreAllActualEmptyOptionalFields
-
describeIgnoreAllExpectedNullFields
-
describeOverriddenEqualsMethodsUsage
private void describeOverriddenEqualsMethodsUsage(StringBuilder description, Representation representation) -
describeIgnoredOverriddenEqualsMethods
private void describeIgnoredOverriddenEqualsMethods(StringBuilder description, Representation representation) -
describeIgnoredOverriddenEqualsForTypes
-
describeIgnoredOverriddenEqualsForFields
-
describeIgnoreCollectionOrder
-
describeIgnoredCollectionOrderInFields
-
describeIgnoredCollectionOrderInFieldsMatchingRegexes
-
matchesAnIgnoredOverriddenEqualsRegex
-
matchesAnIgnoredOverriddenEqualsType
-
matchesAnIgnoredOverriddenEqualsField
-
matchesAnIgnoredNullField
-
matchesAnIgnoredEmptyOptionalField
-
matchesAnIgnoredFieldRegex
-
matchesAnIgnoredFieldType
-
matchesAnIgnoredField
-
matchesAnIgnoredCollectionOrderInField
-
matchesAnIgnoredCollectionOrderInFieldRegex
-
describeIgnoredFields
-
describeComparedFields
-
describeIgnoredTypes
-
join
-
describeIgnoredCollectionOrderInFields
-
describeRegexes
-
isConfiguredToIgnoreSomeButNotAllOverriddenEqualsMethods
private boolean isConfiguredToIgnoreSomeButNotAllOverriddenEqualsMethods() -
describeRegisteredComparatorByTypes
-
describeComparatorForTypes
-
formatRegisteredComparatorByType
-
describeRegisteredComparatorForFields
-
describeComparatorForFields
-
formatRegisteredComparatorForField
private String formatRegisteredComparatorForField(Map.Entry<String, Comparator<?>> comparatorForField) -
describeTypeCheckingStrictness
-
describeRegisteredErrorMessagesForFields
-
describeErrorMessagesForFields
-
describeRegisteredErrorMessagesForTypes
-
describeErrorMessagesForType
-
builder
Creates builder to buildRecursiveComparisonConfiguration
.- Returns:
- created builder
-
toComparator
-