Package org.javers.core.diff.custom

Interface CustomValueComparator<T>

Type Parameters:

T - Value Type

All Known Subinterfaces:

CustomPropertyComparator<T,C>

All Known Implementing Classes:

BigDecimalComparatorWithFixedEquals, CustomBigDecimalComparator

public interface CustomValueComparator<T>

A custom comparator for ValueType classes to be used instead of default Object.equals(Object).

Example implementation: CustomBigDecimalComparator

Usage:

 JaversBuilder.javers()
              .registerValue(BigDecimal.class, new CustomBigDecimalComparator(2))
              .build()
 

See Also:

http://javers.org/documentation/domain-configuration/#ValueType, https://javers.org/documentation/diff-configuration/#custom-comparators

Method Summary

Modifier and Type	Method	Description
boolean	equals(T a, T b)	Called by JaVers to compare two Values.
java.lang.String	toString(T value)	This method has two roles.

Method Detail

equals

boolean equals(T a,
               T b)

Called by JaVers to compare two Values.

Parameters:

a - not null

b - not null

toString

java.lang.String toString(T value)

This method has two roles. First, it is used when Values are compared in hashing contexts. Second, it is used to build Entity Ids from Values.

Hashcode role

When a Value class has custom toString(), it is used instead of Object.hashCode() when comparing Values in hashing contexts, so:

• Sets with Values
• Lists with Values compared as ListCompareAlgorithm.AS_SET
• Maps with Values as keys

Custom toString() implementation should be aligned with custom equals(Object, Object) in the same way like Object.hashCode() should be aligned with Object.equals(Object).

Entity Id role

Each Value can serve as an Entity Id.
When a Value has custom toString() function, it is used for creating InstanceId for Entities. If a Value doesn't have a custom toString() , default ReflectionUtil.reflectiveToString(Object)) is used.

See full example CustomToStringExample.groovy.

Parameters:

value - not null