How to use RecursiveComparisonAssert method of org.assertj.core.api.RecursiveComparisonAssert class

Best Assertj code snippet using org.assertj.core.api.RecursiveComparisonAssert.RecursiveComparisonAssert

Source:RecursiveComparisonConfiguration.java

...30import java.util.Set;31import java.util.function.BiPredicate;32import java.util.regex.Pattern;33import java.util.stream.Stream;34import org.assertj.core.api.RecursiveComparisonAssert;35import org.assertj.core.internal.Objects;36import org.assertj.core.internal.TypeComparators;37import org.assertj.core.presentation.Representation;38import org.assertj.core.util.VisibleForTesting;39public class RecursiveComparisonConfiguration {40  public static final String INDENT_LEVEL_2 = "  -";41  private boolean strictTypeChecking = false;42  // fields to ignore section43  private boolean ignoreAllActualNullFields = false;44  private boolean ignoreAllActualEmptyOptionalFields = false;45  private boolean ignoreAllExpectedNullFields = false;46  private Set<String> ignoredFields = new LinkedHashSet<>();47  private List<Pattern> ignoredFieldsRegexes = new ArrayList<>();48  private Set<Class<?>> ignoredTypes = new LinkedHashSet<>();49  // overridden equals method to ignore section50  private List<Class<?>> ignoredOverriddenEqualsForTypes = new ArrayList<>();51  private List<String> ignoredOverriddenEqualsForFields = new ArrayList<>();52  private List<Pattern> ignoredOverriddenEqualsForFieldsMatchingRegexes = new ArrayList<>();53  private boolean ignoreAllOverriddenEquals = true;54  // ignore order in collections section55  private boolean ignoreCollectionOrder = false;56  private Set<String> ignoredCollectionOrderInFields = new LinkedHashSet<>();57  private List<Pattern> ignoredCollectionOrderInFieldsMatchingRegexes = new ArrayList<>();58  // registered comparators section59  private TypeComparators typeComparators = defaultTypeComparators();60  private FieldComparators fieldComparators = new FieldComparators();61  private RecursiveComparisonConfiguration(Builder builder) {62    this.strictTypeChecking = builder.strictTypeChecking;63    this.ignoreAllActualNullFields = builder.ignoreAllActualNullFields;64    this.ignoreAllActualEmptyOptionalFields = builder.ignoreAllActualEmptyOptionalFields;65    this.ignoreAllExpectedNullFields = builder.ignoreAllExpectedNullFields;66    this.ignoredFields = newLinkedHashSet(builder.ignoredFields);67    ignoreFieldsMatchingRegexes(builder.ignoredFieldsMatchingRegexes);68    ignoreFieldsOfTypes(builder.ignoredTypes);69    ignoreOverriddenEqualsForTypes(builder.ignoredOverriddenEqualsForTypes);70    this.ignoredOverriddenEqualsForFields = list(builder.ignoredOverriddenEqualsForFields);71    ignoreOverriddenEqualsForFieldsMatchingRegexes(builder.ignoredOverriddenEqualsForFieldsMatchingRegexes);72    this.ignoreAllOverriddenEquals = builder.ignoreAllOverriddenEquals;73    this.ignoreCollectionOrder = builder.ignoreCollectionOrder;74    this.ignoredCollectionOrderInFields = newLinkedHashSet(builder.ignoredCollectionOrderInFields);75    ignoreCollectionOrderInFieldsMatchingRegexes(builder.ignoredCollectionOrderInFieldsMatchingRegexes);76    this.typeComparators = builder.typeComparators;77    this.fieldComparators = builder.fieldComparators;78  }79  public RecursiveComparisonConfiguration() {}80  public boolean hasComparatorForField(String fieldName) {81    return fieldComparators.hasComparatorForField(fieldName);82  }83  public Comparator<?> getComparatorForField(String fieldName) {84    return fieldComparators.getComparatorForField(fieldName);85  }86  public FieldComparators getFieldComparators() {87    return fieldComparators;88  }89  public boolean hasComparatorForType(Class<?> keyType) {90    return typeComparators.hasComparatorForType(keyType);91  }92  public boolean hasCustomComparators() {93    return !typeComparators.isEmpty() || !fieldComparators.isEmpty();94  }95  public Comparator<?> getComparatorForType(Class<?> fieldType) {96    return typeComparators.get(fieldType);97  }98  public TypeComparators getTypeComparators() {99    return typeComparators;100  }101  Stream<Entry<Class<?>, Comparator<?>>> comparatorByTypes() {102    return typeComparators.comparatorByTypes();103  }104  @VisibleForTesting105  boolean getIgnoreAllActualNullFields() {106    return ignoreAllActualNullFields;107  }108  @VisibleForTesting109  boolean getIgnoreAllExpectedNullFields() {110    return ignoreAllExpectedNullFields;111  }112  @VisibleForTesting113  boolean getIgnoreAllOverriddenEquals() {114    return ignoreAllOverriddenEquals;115  }116  /**117   * Sets whether actual empty optional fields are ignored in the recursive comparison.118   * <p>119   * See {@link RecursiveComparisonAssert#ignoringActualNullFields()} for code examples.120   *121   * @param ignoringAllActualEmptyOptionalFields whether to ignore actual empty optional fields in the recursive comparison122   */123  public void setIgnoreAllActualEmptyOptionalFields(boolean ignoringAllActualEmptyOptionalFields) {124    this.ignoreAllActualEmptyOptionalFields = ignoringAllActualEmptyOptionalFields;125  }126  @VisibleForTesting127  boolean getIgnoreAllActualEmptyOptionalFields() {128    return ignoreAllActualEmptyOptionalFields;129  }130  /**131   * Sets whether actual null fields are ignored in the recursive comparison.132   * <p>133   * See {@link RecursiveComparisonAssert#ignoringActualNullFields()} for code examples.134   *135   * @param ignoreAllActualNullFields whether to ignore actual null fields in the recursive comparison136   */137  public void setIgnoreAllActualNullFields(boolean ignoreAllActualNullFields) {138    this.ignoreAllActualNullFields = ignoreAllActualNullFields;139  }140  /**141   * Sets whether expected null fields are ignored in the recursive comparison.142   * <p>143   * See {@link RecursiveComparisonAssert#ignoringExpectedNullFields()} for code examples.144   *145   * @param ignoreAllExpectedNullFields whether to ignore expected null fields in the recursive comparison146   */147  public void setIgnoreAllExpectedNullFields(boolean ignoreAllExpectedNullFields) {148    this.ignoreAllExpectedNullFields = ignoreAllExpectedNullFields;149  }150  /**151   * Adds the given fields to the list of the object under test fields to ignore in the recursive comparison.152   * <p>153   * The field are ignored by name, not by value.154   * <p>155   * See {@link RecursiveComparisonAssert#ignoringFields(String...) RecursiveComparisonAssert#ignoringFields(String...)} for examples.156   *157   * @param fieldsToIgnore the fields of the object under test to ignore in the comparison.158   */159  public void ignoreFields(String... fieldsToIgnore) {160    List<String> fieldLocations = list(fieldsToIgnore);161    ignoredFields.addAll(fieldLocations);162  }163  /**164   * 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.165   * <p>166   * See {@link RecursiveComparisonAssert#ignoringFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringFieldsMatchingRegexes(String...)} for examples.167   *168   * @param regexes regexes used to ignore fields in the comparison.169   */170  public void ignoreFieldsMatchingRegexes(String... regexes) {171    ignoredFieldsRegexes.addAll(Stream.of(regexes)172                                      .map(Pattern::compile)173                                      .collect(toList()));174  }175  /**176   * Adds the given types to the list of the object under test fields types to ignore in the recursive comparison.177   * 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.178   * <p>179   * Note that if some object under test fields are null, they are not ignored by this method as their type can't be evaluated.180   * <p>181   * See {@link RecursiveComparisonAssert#ignoringFields(String...) RecursiveComparisonAssert#ignoringFieldsOfTypes(Class...)} for examples.182   *183   * @param types the types of the object under test to ignore in the comparison.184   */185  public void ignoreFieldsOfTypes(Class<?>... types) {186    stream(types).map(RecursiveComparisonConfiguration::asWrapperIfPrimitiveType).forEach(ignoredTypes::add);187  }188  private static Class<?> asWrapperIfPrimitiveType(Class<?> type) {189    if (!type.isPrimitive()) return type;190    if (type.equals(boolean.class)) return Boolean.class;191    if (type.equals(byte.class)) return Byte.class;192    if (type.equals(int.class)) return Integer.class;193    if (type.equals(short.class)) return Short.class;194    if (type.equals(char.class)) return Character.class;195    if (type.equals(float.class)) return Float.class;196    if (type.equals(double.class)) return Double.class;197    // should not arrive here since we have tested primitive types first198    return type;199  }200  /**201   * Returns the list of the object under test fields to ignore in the recursive comparison.202   *203   * @return the list of the object under test fields to ignore in the recursive comparison.204   */205  public Set<String> getIgnoredFields() {206    return ignoredFields;207  }208  /**209   * Returns the set of the object under test fields types to ignore in the recursive comparison.210   *211   * @return the set of the object under test fields types to ignore in the recursive comparison.212   */213  public Set<Class<?>> getIgnoredTypes() {214    return ignoredTypes;215  }216  /**217   * Force a recursive comparison on all fields (except java types).218   * <p>219   * See {@link RecursiveComparisonAssert#ignoringAllOverriddenEquals()} for examples.220   */221  public void ignoreAllOverriddenEquals() {222    ignoreAllOverriddenEquals = true;223  }224  /**225   * Force a recursive comparison on all fields (except java types).226   * <p>227   * See {@link RecursiveComparisonAssert#usingOverriddenEquals()} for examples.228   */229  public void useOverriddenEquals() {230    ignoreAllOverriddenEquals = false;231  }232  /**233   * Adds the given fields to the list of fields to force a recursive comparison on.234   * <p>235   * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForFields(String...) RecursiveComparisonAssert#ignoringOverriddenEqualsForFields(String...)} for examples.236   *237   * @param fields the fields to force a recursive comparison on.238   */239  public void ignoreOverriddenEqualsForFields(String... fields) {240    List<String> fieldLocations = list(fields);241    ignoredOverriddenEqualsForFields.addAll(fieldLocations);242  }243  /**244   * Adds the given regexes to the list of regexes used find the fields to force a recursive comparison on.245   * <p>246   * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringOverriddenEqualsForFieldsMatchingRegexes(String...)} for examples.247   *248   * @param regexes regexes used to specify the fields we want to force a recursive comparison on.249   */250  public void ignoreOverriddenEqualsForFieldsMatchingRegexes(String... regexes) {251    ignoredOverriddenEqualsForFieldsMatchingRegexes.addAll(Stream.of(regexes)252                                                                 .map(Pattern::compile)253                                                                 .collect(toList()));254  }255  /**256   * Adds the given types to the list of types to force a recursive comparison on.257   * <p>258   * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForTypes(Class...) RecursiveComparisonAssert#ignoringOverriddenEqualsForTypes(Class...)} for examples.259   *260   * @param types the types to the list of types to force a recursive comparison on.261   */262  public void ignoreOverriddenEqualsForTypes(Class<?>... types) {263    ignoredOverriddenEqualsForTypes.addAll(list(types));264  }265  @VisibleForTesting266  boolean getIgnoreCollectionOrder() {267    return ignoreCollectionOrder;268  }269  /**270   * Sets whether to ignore collection order in the comparison.271   * <p>272   * See {@link RecursiveComparisonAssert#ignoringCollectionOrder()} for code examples.273   *274   * @param ignoreCollectionOrder whether to ignore collection order in the comparison.275   */276  public void ignoreCollectionOrder(boolean ignoreCollectionOrder) {277    this.ignoreCollectionOrder = ignoreCollectionOrder;278  }279  /**280   * Adds the given fields to the list of the object under test fields to ignore collection order in the recursive comparison.281   * <p>282   * See {@link RecursiveComparisonAssert#ignoringCollectionOrderInFields(String...) RecursiveComparisonAssert#ignoringCollectionOrderInFields(String...)} for examples.283   *284   * @param fieldsToIgnoreCollectionOrder the fields of the object under test to ignore collection order in the comparison.285   */286  public void ignoreCollectionOrderInFields(String... fieldsToIgnoreCollectionOrder) {287    List<String> fieldLocations = list(fieldsToIgnoreCollectionOrder);288    ignoredCollectionOrderInFields.addAll(fieldLocations);289  }290  /**291   * Returns the list of the object under test fields to ignore collection order in the recursive comparison.292   *293   * @return the list of the object under test fields to ignore collection order in the recursive comparison.294   */295  public Set<String> getIgnoredCollectionOrderInFields() {296    return ignoredCollectionOrderInFields;297  }298  /**299   * 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.300   * <p>301   * See {@link RecursiveComparisonAssert#ignoringCollectionOrderInFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringCollectionOrderInFieldsMatchingRegexes(String...)} for examples.302   *303   * @param regexes regexes used to find the object under test fields to ignore collection order in in the comparison.304   */305  public void ignoreCollectionOrderInFieldsMatchingRegexes(String... regexes) {306    ignoredCollectionOrderInFieldsMatchingRegexes.addAll(Stream.of(regexes)307                                                               .map(Pattern::compile)308                                                               .collect(toList()));309  }310  /**311   * Returns the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.312   *313   * @return the list of regexes used to find the object under test fields to ignore collection order in the recursive comparison.314   */315  public List<Pattern> getIgnoredCollectionOrderInFieldsMatchingRegexes() {316    return ignoredCollectionOrderInFieldsMatchingRegexes;317  }318  /**319   * Registers the given {@link Comparator} to compare the fields with the given type.320   * <p>321   * Comparators registered with this method have less precedence than comparators registered with {@link #registerComparatorForFields(Comparator, String...)}.322   * <p>323   * Note that registering a {@link Comparator} for a given type will override the previously registered BiPredicate/Comparator (if any).324   * <p>325   * See {@link RecursiveComparisonAssert#withComparatorForType(Comparator, Class)} for examples.326   *327   * @param <T> the class type to register a comparator for328   * @param comparator the {@link java.util.Comparator Comparator} to use to compare the given type329   * @param type the type to be compared with the given comparator.330   * @throws NullPointerException if the given comparator is null.331   */332  public <T> void registerComparatorForType(Comparator<? super T> comparator, Class<T> type) {333    requireNonNull(comparator, "Expecting a non null Comparator");334    typeComparators.put(type, comparator);335  }336  /**337   * Registers the given {@link BiPredicate} to compare the fields with the given type.338   * <p>339   * BiPredicates specified with this method have less precedence than the ones registered with {@link #registerEqualsForFields(BiPredicate, String...)}340   * or comparators registered with {@link #registerComparatorForFields(Comparator, String...)}.341   * <p>342   * Note that registering a {@link BiPredicate} for a given type will override the previously registered BiPredicate/Comparator (if any).343   * <p>344   * See {@link RecursiveComparisonAssert#withEqualsForType(BiPredicate, Class)} for examples.345   *346   * @param <T> the class type to register a comparator for347   * @param equals the equals implementation to compare the given type348   * @param type the type to be compared with the given equals implementation .349   * @throws NullPointerException if the given BiPredicate is null.350   * @since 3.17.0351   */352  @SuppressWarnings("unchecked")353  public <T> void registerEqualsForType(BiPredicate<? super T, ? super T> equals, Class<T> type) {354    registerComparatorForType(toComparator(equals), type);355  }356  /**357   * Registers the given {@link Comparator} to compare the fields at the given locations.358   * <p>359   * The fields must be specified from the root object, for example if {@code Foo} has a {@code Bar} field and both have an {@code id} field,360   * one can register a comparator for Foo and Bar's {@code id} by calling:361   * <pre><code class='java'> registerComparatorForFields(idComparator, "foo.id", "foo.bar.id")</code></pre>362   * <p>363   * Comparators registered with this method have precedence over comparators registered with {@link #registerComparatorForType(Comparator, Class)}.364   * <p>365   * Note that registering a {@link Comparator} for a given field will override the previously registered BiPredicate/Comparator (if any).366   * <p>367   * See {@link RecursiveComparisonAssert#withComparatorForFields(Comparator, String...) RecursiveComparisonAssert#withComparatorForFields(Comparator, String...)} for examples.368   *369   * @param comparator the {@link java.util.Comparator Comparator} to use to compare the given field370   * @param fieldLocations the locations from the root object of the fields the comparator should be used for371   * @throws NullPointerException if the given comparator is null.372   */373  public void registerComparatorForFields(Comparator<?> comparator, String... fieldLocations) {374    requireNonNull(comparator, "Expecting a non null Comparator");375    Stream.of(fieldLocations).forEach(fieldLocation -> fieldComparators.registerComparator(fieldLocation, comparator));376  }377  /**378   * Registers the given {@link BiPredicate} to compare the fields at the given locations.379   * <p>380   * The fields must be specified from the root object, for example if {@code Foo} has a {@code Bar} field and both have an {@code id} field,381   * one can register a BiPredicate for Foo and Bar's {@code id} by calling:382   * <pre><code class='java'> registerEqualsForFields(idBiPredicate, "foo.id", "foo.bar.id")</code></pre>383   * <p>384   * BiPredicates registered with this method have precedence over the ones registered with {@link #registerEqualsForType(BiPredicate, Class)}385   * or the comparators registered with {@link #registerComparatorForType(Comparator, Class)}.386   * <p>387   * Note that registering a {@link BiPredicate} for a given field will override the previously registered BiPredicate/Comparator (if any).388   * <p>389   * See {@link RecursiveComparisonAssert#withEqualsForFields(BiPredicate, String...) RecursiveComparisonAssert#withEqualsForFields(BiPredicate, String...)} for examples.390   *391   * @param equals the equals implementation to compare the given fields.392   * @param fieldLocations the locations from the root object of the fields the comparator should be used for393   * @throws NullPointerException if the given BiPredicate is null.394   * @since 3.17.0395   */396  public void registerEqualsForFields(BiPredicate<?, ?> equals, String... fieldLocations) {397    registerComparatorForFields(toComparator(equals), fieldLocations);398  }399  /**400   * Sets whether the recursive comparison will check that actual's type is compatible with expected's type (the same applies for each field).401   * Compatible means that the expected's type is the same or a subclass of actual's type.402   * <p>403   * See {@link RecursiveComparisonAssert#withStrictTypeChecking()} for code examples.404   *405   * @param strictTypeChecking whether the recursive comparison will check that actual's type is compatible with expected's type.406   */407  public void strictTypeChecking(boolean strictTypeChecking) {408    this.strictTypeChecking = strictTypeChecking;409  }410  public boolean isInStrictTypeCheckingMode() {411    return strictTypeChecking;412  }413  public List<Pattern> getIgnoredFieldsRegexes() {414    return ignoredFieldsRegexes;415  }416  public List<Class<?>> getIgnoredOverriddenEqualsForTypes() {417    return ignoredOverriddenEqualsForTypes;418  }419  public List<String> getIgnoredOverriddenEqualsForFields() {420    return ignoredOverriddenEqualsForFields;421  }422  public List<Pattern> getIgnoredOverriddenEqualsForFieldsMatchingRegexes() {423    return ignoredOverriddenEqualsForFieldsMatchingRegexes;424  }425  public Stream<Entry<String, Comparator<?>>> comparatorByFields() {426    return fieldComparators.comparatorByFields();427  }428  @Override429  public String toString() {430    return multiLineDescription(CONFIGURATION_PROVIDER.representation());431  }432  @Override433  public int hashCode() {434    return java.util.Objects.hash(fieldComparators, ignoreAllActualEmptyOptionalFields, ignoreAllActualNullFields,435                                  ignoreAllExpectedNullFields, ignoreAllOverriddenEquals, ignoreCollectionOrder,436                                  ignoredCollectionOrderInFields, ignoredCollectionOrderInFieldsMatchingRegexes, ignoredFields,437                                  ignoredFieldsRegexes, ignoredOverriddenEqualsForFields, ignoredOverriddenEqualsForTypes,438                                  ignoredOverriddenEqualsForFieldsMatchingRegexes, ignoredTypes, strictTypeChecking,439                                  typeComparators);440  }441  @Override442  public boolean equals(Object obj) {443    if (this == obj) return true;444    if (obj == null) return false;445    if (getClass() != obj.getClass()) return false;446    RecursiveComparisonConfiguration other = (RecursiveComparisonConfiguration) obj;447    return java.util.Objects.equals(fieldComparators, other.fieldComparators)448           && ignoreAllActualEmptyOptionalFields == other.ignoreAllActualEmptyOptionalFields449           && ignoreAllActualNullFields == other.ignoreAllActualNullFields450           && ignoreAllExpectedNullFields == other.ignoreAllExpectedNullFields451           && ignoreAllOverriddenEquals == other.ignoreAllOverriddenEquals452           && ignoreCollectionOrder == other.ignoreCollectionOrder453           && java.util.Objects.equals(ignoredCollectionOrderInFields, other.ignoredCollectionOrderInFields)454           && java.util.Objects.equals(ignoredFields, other.ignoredFields)455           && java.util.Objects.equals(ignoredFieldsRegexes, other.ignoredFieldsRegexes)456           && java.util.Objects.equals(ignoredOverriddenEqualsForFields, other.ignoredOverriddenEqualsForFields)457           && java.util.Objects.equals(ignoredOverriddenEqualsForTypes, other.ignoredOverriddenEqualsForTypes)458           && java.util.Objects.equals(ignoredOverriddenEqualsForFieldsMatchingRegexes,459                                       other.ignoredOverriddenEqualsForFieldsMatchingRegexes)460           && java.util.Objects.equals(ignoredTypes, other.ignoredTypes) && strictTypeChecking == other.strictTypeChecking461           && java.util.Objects.equals(typeComparators, other.typeComparators)462           && java.util.Objects.equals(ignoredCollectionOrderInFieldsMatchingRegexes,463                                       other.ignoredCollectionOrderInFieldsMatchingRegexes);464  }465  public String multiLineDescription(Representation representation) {466    StringBuilder description = new StringBuilder();467    describeIgnoreAllActualNullFields(description);468    describeIgnoreAllActualEmptyOptionalFields(description);469    describeIgnoreAllExpectedNullFields(description);470    describeIgnoredFields(description);471    describeIgnoredFieldsRegexes(description);472    describeIgnoredFieldsForTypes(description);473    describeOverriddenEqualsMethodsUsage(description, representation);474    describeIgnoreCollectionOrder(description);475    describeIgnoredCollectionOrderInFields(description);476    describeIgnoredCollectionOrderInFieldsMatchingRegexes(description);477    describeRegisteredComparatorByTypes(description);478    describeRegisteredComparatorForFields(description);479    describeTypeCheckingStrictness(description);480    return description.toString();481  }482  boolean shouldIgnore(DualValue dualValue) {483    FieldLocation fieldLocation = dualValue.fieldLocation;484    return matchesAnIgnoredField(fieldLocation)485           || matchesAnIgnoredFieldRegex(fieldLocation)486           || shouldIgnoreFieldBasedOnFieldValue(dualValue);487  }488  Set<String> getNonIgnoredActualFieldNames(DualValue dualValue) {489    Set<String> actualFieldsNames = Objects.getFieldsNames(dualValue.actual.getClass());490    // we are doing the same as shouldIgnore(DualValue dualValue) but in two steps for performance reasons:491    // - we filter first ignored field by names that don't need building DualValues492    // - then we filter field DualValues with the remaining criteria that need to get the field value493    // DualValues are built introspecting fields which is expensive.494    return actualFieldsNames.stream()495                            // evaluate field name ignoring criteria on dualValue field location + field name496                            .filter(fieldName -> !shouldIgnoreFieldBasedOnFieldLocation(dualValue.fieldLocation.field(fieldName)))497                            .map(fieldName -> dualValueForField(dualValue, fieldName))498                            // evaluate field value ignoring criteria499                            .filter(fieldDualValue -> !shouldIgnoreFieldBasedOnFieldValue(fieldDualValue))500                            // back to field name501                            .map(DualValue::getFieldName)502                            .filter(fieldName -> !fieldName.isEmpty())503                            .collect(toSet());504  }505  // non accessible stuff506  private boolean shouldIgnoreFieldBasedOnFieldValue(DualValue dualValue) {507    return matchesAnIgnoredNullField(dualValue)508           || matchesAnIgnoredFieldType(dualValue)509           || matchesAnIgnoredEmptyOptionalField(dualValue);510  }511  private boolean shouldIgnoreFieldBasedOnFieldLocation(FieldLocation fieldLocation) {512    return matchesAnIgnoredField(fieldLocation) || matchesAnIgnoredFieldRegex(fieldLocation);513  }514  private static DualValue dualValueForField(DualValue parentDualValue, String fieldName) {515    Object actualFieldValue = COMPARISON.getSimpleValue(fieldName, parentDualValue.actual);516    // no guarantees we have a field in expected named as fieldName517    Object expectedFieldValue;518    try {519      expectedFieldValue = COMPARISON.getSimpleValue(fieldName, parentDualValue.expected);520    } catch (@SuppressWarnings("unused") Exception e) {521      // set the field to null to express it is absent, this not 100% accurate as the value could be null522      // but it works to evaluate if dualValue should be ignored with matchesAnIgnoredFieldType523      expectedFieldValue = null;524    }525    FieldLocation fieldLocation = parentDualValue.fieldLocation.field(fieldName);526    return new DualValue(fieldLocation, actualFieldValue, expectedFieldValue);527  }528  boolean hasCustomComparator(DualValue dualValue) {529    String fieldName = dualValue.getConcatenatedPath();530    if (hasComparatorForField(fieldName)) return true;531    if (dualValue.actual == null && dualValue.expected == null) return false;532    // best effort assuming actual and expected have the same type (not 100% true as we can compare object of differennt types)533    Class<?> valueType = dualValue.actual != null ? dualValue.actual.getClass() : dualValue.expected.getClass();534    return hasComparatorForType(valueType);535  }536  boolean shouldIgnoreOverriddenEqualsOf(DualValue dualValue) {537    // we must compare java basic types otherwise the recursive comparison loops infinitely!538    if (dualValue.isActualJavaType()) return false;539    // enums don't have fields, comparing them field by field has no sense, we need to use equals which is overridden and final540    if (dualValue.isActualAnEnum()) return false;541    return ignoreAllOverriddenEquals542           || matchesAnIgnoredOverriddenEqualsField(dualValue.fieldLocation)543           || (dualValue.actual != null && shouldIgnoreOverriddenEqualsOf(dualValue.actual.getClass()));544  }545  @VisibleForTesting546  boolean shouldIgnoreOverriddenEqualsOf(Class<? extends Object> clazz) {547    return matchesAnIgnoredOverriddenEqualsRegex(clazz) || matchesAnIgnoredOverriddenEqualsType(clazz);548  }549  boolean shouldIgnoreCollectionOrder(FieldLocation fieldLocation) {550    return ignoreCollectionOrder551           || matchesAnIgnoredCollectionOrderInField(fieldLocation)552           || matchesAnIgnoredCollectionOrderInFieldRegex(fieldLocation);553  }554  private void describeIgnoredFieldsRegexes(StringBuilder description) {555    if (!ignoredFieldsRegexes.isEmpty())556      description.append(format("- the fields matching the following regexes were ignored in the comparison: %s%n",557                                describeRegexes(ignoredFieldsRegexes)));558  }559  private void describeIgnoredFields(StringBuilder description) {560    if (!ignoredFields.isEmpty())561      description.append(format("- the following fields were ignored in the comparison: %s%n", describeIgnoredFields()));562  }563  private void describeIgnoredFieldsForTypes(StringBuilder description) {564    if (!ignoredTypes.isEmpty())565      description.append(format("- the following types were ignored in the comparison: %s%n", describeIgnoredTypes()));566  }567  private void describeIgnoreAllActualNullFields(StringBuilder description) {568    if (ignoreAllActualNullFields) description.append(format("- all actual null fields were ignored in the comparison%n"));569  }570  private void describeIgnoreAllActualEmptyOptionalFields(StringBuilder description) {571    if (getIgnoreAllActualEmptyOptionalFields())572      description.append(format("- all actual empty optional fields were ignored in the comparison (including Optional, OptionalInt, OptionalLong and OptionalDouble)%n"));573  }574  private void describeIgnoreAllExpectedNullFields(StringBuilder description) {575    if (ignoreAllExpectedNullFields) description.append(format("- all expected null fields were ignored in the comparison%n"));576  }577  private void describeOverriddenEqualsMethodsUsage(StringBuilder description, Representation representation) {578    String header = ignoreAllOverriddenEquals579        ? "- no overridden equals methods were used in the comparison (except for java types)"580        : "- overridden equals methods were used in the comparison";581    description.append(header);582    if (isConfiguredToIgnoreSomeButNotAllOverriddenEqualsMethods()) {583      description.append(format(" except for:%n"));584      describeIgnoredOverriddenEqualsMethods(description, representation);585    } else {586      description.append(format("%n"));587    }588  }589  private void describeIgnoredOverriddenEqualsMethods(StringBuilder description, Representation representation) {590    if (!ignoredOverriddenEqualsForFields.isEmpty())591      description.append(format("%s the following fields: %s%n", INDENT_LEVEL_2,592                                describeIgnoredOverriddenEqualsForFields()));593    if (!ignoredOverriddenEqualsForTypes.isEmpty())594      description.append(format("%s the following types: %s%n", INDENT_LEVEL_2,595                                describeIgnoredOverriddenEqualsForTypes(representation)));596    if (!ignoredOverriddenEqualsForFieldsMatchingRegexes.isEmpty())597      description.append(format("%s the types matching the following regexes: %s%n", INDENT_LEVEL_2,598                                describeRegexes(ignoredOverriddenEqualsForFieldsMatchingRegexes)));599  }600  private String describeIgnoredOverriddenEqualsForTypes(Representation representation) {601    List<String> fieldsDescription = ignoredOverriddenEqualsForTypes.stream()602                                                                    .map(representation::toStringOf)603                                                                    .collect(toList());604    return join(fieldsDescription).with(", ");605  }606  private String describeIgnoredOverriddenEqualsForFields() {607    return join(ignoredOverriddenEqualsForFields).with(", ");608  }609  private void describeIgnoreCollectionOrder(StringBuilder description) {610    if (ignoreCollectionOrder) description.append(format("- collection order was ignored in all fields in the comparison%n"));611  }612  private void describeIgnoredCollectionOrderInFields(StringBuilder description) {613    if (!ignoredCollectionOrderInFields.isEmpty())614      description.append(format("- collection order was ignored in the following fields in the comparison: %s%n",615                                describeIgnoredCollectionOrderInFields()));616  }617  private void describeIgnoredCollectionOrderInFieldsMatchingRegexes(StringBuilder description) {618    if (!ignoredCollectionOrderInFieldsMatchingRegexes.isEmpty())619      description.append(format("- collection order was ignored in the fields matching the following regexes in the comparison: %s%n",620                                describeRegexes(ignoredCollectionOrderInFieldsMatchingRegexes)));621  }622  private boolean matchesAnIgnoredOverriddenEqualsRegex(Class<?> clazz) {623    if (ignoredOverriddenEqualsForFieldsMatchingRegexes.isEmpty()) return false; // shortcut624    String canonicalName = clazz.getCanonicalName();625    return ignoredOverriddenEqualsForFieldsMatchingRegexes.stream()626                                                          .anyMatch(regex -> regex.matcher(canonicalName).matches());627  }628  private boolean matchesAnIgnoredOverriddenEqualsType(Class<?> clazz) {629    return ignoredOverriddenEqualsForTypes.contains(clazz);630  }631  private boolean matchesAnIgnoredOverriddenEqualsField(FieldLocation fieldLocation) {632    return ignoredOverriddenEqualsForFields.stream().anyMatch(fieldLocation::matches);633  }634  private boolean matchesAnIgnoredNullField(DualValue dualValue) {635    return (ignoreAllActualNullFields && dualValue.actual == null)636           || (ignoreAllExpectedNullFields && dualValue.expected == null);637  }638  private boolean matchesAnIgnoredEmptyOptionalField(DualValue dualValue) {639    return ignoreAllActualEmptyOptionalFields640           && dualValue.isActualFieldAnEmptyOptionalOfAnyType();641  }642  private boolean matchesAnIgnoredFieldRegex(FieldLocation fieldLocation) {643    return ignoredFieldsRegexes.stream()644                               .anyMatch(regex -> regex.matcher(fieldLocation.getPathToUseInRules()).matches());645  }646  private boolean matchesAnIgnoredFieldType(DualValue dualValue) {647    Object actual = dualValue.actual;648    if (actual != null) return ignoredTypes.contains(actual.getClass());649    Object expected = dualValue.expected;650    // actual is null => we can't evaluate its type, we can only reliably check dualValue.expected's type if651    // strictTypeChecking is enabled which guarantees expected is of the same type.652    if (strictTypeChecking && expected != null) return ignoredTypes.contains(expected.getClass());653    // if strictTypeChecking is disabled, we can't safely ignore the field (if we did, we would ignore all null fields!).654    return false;655  }656  private boolean matchesAnIgnoredField(FieldLocation fieldLocation) {657    return ignoredFields.stream().anyMatch(fieldLocation::matches);658  }659  private boolean matchesAnIgnoredCollectionOrderInField(FieldLocation fieldLocation) {660    return ignoredCollectionOrderInFields.stream().anyMatch(fieldLocation::matches);661  }662  private boolean matchesAnIgnoredCollectionOrderInFieldRegex(FieldLocation fieldLocation) {663    String pathToUseInRules = fieldLocation.getPathToUseInRules();664    return ignoredCollectionOrderInFieldsMatchingRegexes.stream().anyMatch(regex -> regex.matcher(pathToUseInRules).matches());665  }666  private String describeIgnoredFields() {667    return join(ignoredFields).with(", ");668  }669  private String describeIgnoredTypes() {670    List<String> typesDescription = ignoredTypes.stream()671                                                .map(Class::getName)672                                                .collect(toList());673    return join(typesDescription).with(", ");674  }675  private String describeIgnoredCollectionOrderInFields() {676    return join(ignoredCollectionOrderInFields).with(", ");677  }678  private String describeRegexes(List<Pattern> regexes) {679    List<String> fieldsDescription = regexes.stream()680                                            .map(Pattern::pattern)681                                            .collect(toList());682    return join(fieldsDescription).with(", ");683  }684  private boolean isConfiguredToIgnoreSomeButNotAllOverriddenEqualsMethods() {685    boolean ignoreSomeOverriddenEqualsMethods = !ignoredOverriddenEqualsForFieldsMatchingRegexes.isEmpty()686                                                || !ignoredOverriddenEqualsForTypes.isEmpty()687                                                || !ignoredOverriddenEqualsForFields.isEmpty();688    return !ignoreAllOverriddenEquals && ignoreSomeOverriddenEqualsMethods;689  }690  private void describeRegisteredComparatorByTypes(StringBuilder description) {691    if (!typeComparators.isEmpty()) {692      description.append(format("- these types were compared with the following comparators:%n"));693      describeComparatorForTypes(description);694    }695  }696  private void describeComparatorForTypes(StringBuilder description) {697    typeComparators.comparatorByTypes()698                   .map(this::formatRegisteredComparatorByType)699                   .forEach(description::append);700  }701  private String formatRegisteredComparatorByType(Entry<Class<?>, Comparator<?>> next) {702    return format("%s %s -> %s%n", INDENT_LEVEL_2, next.getKey().getName(), next.getValue());703  }704  private void describeRegisteredComparatorForFields(StringBuilder description) {705    if (!fieldComparators.isEmpty()) {706      description.append(format("- these fields were compared with the following comparators:%n"));707      describeComparatorForFields(description);708      if (!typeComparators.isEmpty()) {709        description.append(format("- field comparators take precedence over type comparators.%n"));710      }711    }712  }713  private void describeComparatorForFields(StringBuilder description) {714    fieldComparators.comparatorByFields()715                    .map(this::formatRegisteredComparatorForField)716                    .forEach(description::append);717  }718  private String formatRegisteredComparatorForField(Entry<String, Comparator<?>> comparatorForField) {719    return format("%s %s -> %s%n", INDENT_LEVEL_2, comparatorForField.getKey(), comparatorForField.getValue());720  }721  private void describeTypeCheckingStrictness(StringBuilder description) {722    String str = strictTypeChecking723        ? "- actual and expected objects and their fields were considered different when of incompatible types (i.e. expected type does not extend actual's type) even if all their fields match, for example a Person instance will never match a PersonDto (call strictTypeChecking(false) to change that behavior).%n"724        : "- actual and expected objects and their fields were compared field by field recursively even if they were not of the same type, this allows for example to compare a Person to a PersonDto (call strictTypeChecking(true) to change that behavior).%n";725    description.append(format(str));726  }727  /**728   * Creates builder to build {@link RecursiveComparisonConfiguration}.729   * @return created builder730   */731  public static Builder builder() {732    return new Builder();733  }734  /**735   * Builder to build {@link RecursiveComparisonConfiguration}.736   */737  public static final class Builder {738    private boolean strictTypeChecking;739    private boolean ignoreAllActualNullFields;740    private boolean ignoreAllActualEmptyOptionalFields;741    private boolean ignoreAllExpectedNullFields;742    private String[] ignoredFields = {};743    private String[] ignoredFieldsMatchingRegexes = {};744    private Class<?>[] ignoredTypes = {};745    private Class<?>[] ignoredOverriddenEqualsForTypes = {};746    private String[] ignoredOverriddenEqualsForFields = {};747    private String[] ignoredOverriddenEqualsForFieldsMatchingRegexes = {};748    private boolean ignoreAllOverriddenEquals;749    private boolean ignoreCollectionOrder;750    private String[] ignoredCollectionOrderInFields = {};751    private String[] ignoredCollectionOrderInFieldsMatchingRegexes = {};752    private TypeComparators typeComparators = new TypeComparators();753    private FieldComparators fieldComparators = new FieldComparators();754    private Builder() {}755    /**756     * Sets whether the recursive comparison will check that actual's type is compatible with expected's type (the same applies for each field).757     * Compatible means that the expected's type is the same or a subclass of actual's type.758     * <p>759     * See {@link RecursiveComparisonAssert#withStrictTypeChecking()} for code examples.760     *761     * @param strictTypeChecking whether the recursive comparison will check that actual's type is compatible with expected's type.762     * @return this builder.763     */764    public Builder withStrictTypeChecking(boolean strictTypeChecking) {765      this.strictTypeChecking = strictTypeChecking;766      return this;767    }768    /**769     * Sets whether actual null fields are ignored in the recursive comparison.770     * <p>771     * See {@link RecursiveComparisonAssert#ignoringActualNullFields()} for code examples.772     *773     * @param ignoreAllActualNullFields whether to ignore actual null fields in the recursive comparison774     * @return this builder.775     */776    public Builder withIgnoreAllActualNullFields(boolean ignoreAllActualNullFields) {777      this.ignoreAllActualNullFields = ignoreAllActualNullFields;778      return this;779    }780    /**781     * Sets whether actual empty optional fields are ignored in the recursive comparison.782     * <p>783     * See {@link RecursiveComparisonAssert#ignoringActualEmptyOptionalFields()} for code examples.784     *785     * @param ignoreAllActualEmptyOptionalFields whether to ignore actual empty optional fields in the recursive comparison786     * @return this builder.787     */788    public Builder withIgnoreAllActualEmptyOptionalFields(boolean ignoreAllActualEmptyOptionalFields) {789      this.ignoreAllActualEmptyOptionalFields = ignoreAllActualEmptyOptionalFields;790      return this;791    }792    /**793     * Sets whether expected null fields are ignored in the recursive comparison.794     * <p>795     * See {@link RecursiveComparisonAssert#ignoringExpectedNullFields()} for code examples.796     *797     * @param ignoreAllExpectedNullFields whether to ignore expected null fields in the recursive comparison798     * @return this builder.799     */800    public Builder withIgnoreAllExpectedNullFields(boolean ignoreAllExpectedNullFields) {801      this.ignoreAllExpectedNullFields = ignoreAllExpectedNullFields;802      return this;803    }804    /**805     * Adds the given fields to the list of the object under test fields to ignore in the recursive comparison. Nested fields can be specified like this: home.address.street.806     * <p>807     * See {@link RecursiveComparisonAssert#ignoringFields(String...) RecursiveComparisonAssert#ignoringFields(String...)} for examples.808     *809     * @param fieldsToIgnore the fields of the object under test to ignore in the comparison.810     * @return this builder.811     */812    public Builder withIgnoredFields(String... fieldsToIgnore) {813      this.ignoredFields = fieldsToIgnore;814      return this;815    }816    /**817     * 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.818     * <p>819     * See {@link RecursiveComparisonAssert#ignoringFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringFieldsMatchingRegexes(String...)} for examples.820     *821     * @param regexes regexes used to ignore fields in the comparison.822     * @return this builder.823     */824    public Builder withIgnoredFieldsMatchingRegexes(String... regexes) {825      this.ignoredFieldsMatchingRegexes = regexes;826      return this;827    }828    /**829     * Adds the given types to the list of the object under test fields types to ignore in the recursive comparison.830     * 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.831     * <p>832     * Note that if some object under test fields are null, they are not ignored by this method as their type can't be evaluated.833     * <p>834     * See {@link RecursiveComparisonAssert#ignoringFields(String...) RecursiveComparisonAssert#ignoringFieldsOfTypes(Class...)} for examples.835     *836     * @param types the types of the object under test to ignore in the comparison.837     * @return this builder.838     */839    public Builder withIgnoredFieldsOfTypes(Class<?>... types) {840      this.ignoredTypes = types;841      return this;842    }843    /**844     * Adds the given types to the list of types to force a recursive comparison on.845     * <p>846     * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForTypes(Class...) RecursiveComparisonAssert#ignoringOverriddenEqualsForTypes(Class...)} for examples.847     *848     * @param types the types to the list of types to force a recursive comparison on.849     * @return this builder.850     */851    public Builder withIgnoredOverriddenEqualsForTypes(Class<?>... types) {852      this.ignoredOverriddenEqualsForTypes = types;853      return this;854    }855    /**856     * Adds the given fields to the list of fields to force a recursive comparison on.857     * <p>858     * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForFields(String...) RecursiveComparisonAssert#ignoringOverriddenEqualsForFields(String...)} for examples.859     *860     * @param fields the fields to force a recursive comparison on.861     * @return this builder.862     */863    public Builder withIgnoredOverriddenEqualsForFields(String... fields) {864      this.ignoredOverriddenEqualsForFields = fields;865      return this;866    }867    /**868     * Adds the given regexes to the list of regexes used find the fields to force a recursive comparison on.869     * <p>870     * See {@link RecursiveComparisonAssert#ignoringOverriddenEqualsForFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringOverriddenEqualsForFieldsMatchingRegexes(String...)} for examples.871     *872     * @param regexes regexes used to specify the fields we want to force a recursive comparison on.873     * @return this builder.874     */875    public Builder withIgnoredOverriddenEqualsForFieldsMatchingRegexes(String... regexes) {876      this.ignoredOverriddenEqualsForFieldsMatchingRegexes = regexes;877      return this;878    }879    /**880     * Force a recursive comparison on all fields (except java types) if true.881     * <p>882     * See {@link RecursiveComparisonAssert#ignoringAllOverriddenEquals()} for examples.883     *884     * @param ignoreAllOverriddenEquals whether to force a recursive comparison on all fields (except java types) or not.885     * @return this builder.886     */887    public Builder withIgnoreAllOverriddenEquals(boolean ignoreAllOverriddenEquals) {888      this.ignoreAllOverriddenEquals = ignoreAllOverriddenEquals;889      return this;890    }891    /**892     * Sets whether to ignore collection order in the comparison.893     * <p>894     * See {@link RecursiveComparisonAssert#ignoringCollectionOrder()} for code examples.895     *896     * @param ignoreCollectionOrder whether to ignore collection order in the comparison.897     * @return this builder.898     */899    public Builder withIgnoreCollectionOrder(boolean ignoreCollectionOrder) {900      this.ignoreCollectionOrder = ignoreCollectionOrder;901      return this;902    }903    /**904     * Adds the given fields to the list of the object under test fields to ignore collection order in the recursive comparison.905     * <p>906     * See {@link RecursiveComparisonAssert#ignoringCollectionOrderInFields(String...) RecursiveComparisonAssert#ignoringCollectionOrderInFields(String...)} for examples.907     *908     * @param fieldsToIgnoreCollectionOrder the fields of the object under test to ignore collection order in the comparison.909     * @return this builder.910     */911    public Builder withIgnoredCollectionOrderInFields(String... fieldsToIgnoreCollectionOrder) {912      this.ignoredCollectionOrderInFields = fieldsToIgnoreCollectionOrder;913      return this;914    }915    /**916     * 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.917     * <p>918     * See {@link RecursiveComparisonAssert#ignoringCollectionOrderInFieldsMatchingRegexes(String...) RecursiveComparisonAssert#ignoringCollectionOrderInFieldsMatchingRegexes(String...)} for examples.919     *920     * @param regexes regexes used to find the object under test fields to ignore collection order in in the comparison.921     * @return this builder.922     */923    public Builder withIgnoredCollectionOrderInFieldsMatchingRegexes(String... regexes) {924      this.ignoredCollectionOrderInFieldsMatchingRegexes = regexes;925      return this;926    }927    /**928     * Registers the given {@link Comparator} to compare the fields with the given type.929     * <p>930     * Comparators registered with this method have less precedence than comparators registered with {@link #withComparatorForFields(Comparator, String...)}931     * or BiPredicate registered with  {@link #withEqualsForFields(BiPredicate, String...)}.932     * <p>933     * Note that registering a {@link Comparator} for a given type will override the previously registered BiPredicate/Comparator (if any).934     * <p>935     * See {@link RecursiveComparisonAssert#withComparatorForType(Comparator, Class)} for examples.936     *937     * @param <T> the class type to register a comparator for938     * @param comparator the {@link java.util.Comparator Comparator} to use to compare the given field939     * @param type the type to be compared with the given comparator.940     * @return this builder.941     * @throws NullPointerException if the given Comparator is null.942     */943    public <T> Builder withComparatorForType(Comparator<? super T> comparator, Class<T> type) {944      requireNonNull(comparator, "Expecting a non null Comparator");945      this.typeComparators.put(type, comparator);946      return this;947    }948    /**949     * Registers the given {@link BiPredicate} to compare the fields with the given type.950     * <p>951     * BiPredicates registered with this method have less precedence than the ones registered with {@link #withEqualsForFields(BiPredicate, String...)}952     * or the comparators registered with {@link #withComparatorForFields(Comparator, String...)}.953     * <p>954     * Note that registering a {@link BiPredicate} for a given type will override the previously registered BiPredicate/Comparator (if any).955     * <p>956     * See {@link RecursiveComparisonAssert#withEqualsForType(BiPredicate, Class)} for examples.957     *958     * @param <T> the class type to register a BiPredicate for959     * @param equals the {@link BiPredicate} to use to compare the given field960     * @param type the type to be compared with the given comparator.961     * @return this builder.962     * @since 3.17.0963     * @throws NullPointerException if the given BiPredicate is null.964     */965    @SuppressWarnings("unchecked")966    public <T> Builder withEqualsForType(BiPredicate<? super T, ? super T> equals, Class<T> type) {967      return withComparatorForType(toComparator(equals), type);968    }969    /**970     * Registers the given {@link Comparator} to compare the fields at the given locations.971     * <p>972     * The fields must be specified from the root object, for example if {@code Foo} has a {@code Bar} field and both have an {@code id} field,973     * one can register a comparator for Foo and Bar's {@code id} by calling:974     * <pre><code class='java'> registerComparatorForFields(idComparator, "foo.id", "foo.bar.id")</code></pre>975     * <p>976     * Comparators registered with this method have precedence over comparators registered with {@link #withComparatorForType(Comparator, Class)}977     * or BiPredicate registered with {@link #withEqualsForType(BiPredicate, Class)}.978     * <p>979     * Note that registering a {@link Comparator} for a given field will override the previously registered BiPredicate/Comparator (if any).980     * <p>981     * See {@link RecursiveComparisonAssert#withComparatorForFields(Comparator, String...) RecursiveComparisonAssert#withComparatorForFields(Comparator comparator, String...fields)} for examples.982     *983     * @param comparator the {@link java.util.Comparator Comparator} to use to compare the given field984     * @param fields the fields the comparator should be used for985     * @return this builder.986     * @throws NullPointerException if the given Comparator is null.987     */988    public Builder withComparatorForFields(Comparator<?> comparator, String... fields) {989      requireNonNull(comparator, "Expecting a non null Comparator");990      Stream.of(fields).forEach(fieldLocation -> fieldComparators.registerComparator(fieldLocation, comparator));991      return this;992    }993    /**994     * Registers the given {@link BiPredicate} to compare the fields at the given locations.995     * <p>996     * The fields must be specified from the root object, for example if {@code Foo} has a {@code Bar} field and both have an {@code id} field,997     * one can register a BiPredicate for Foo and Bar's {@code id} by calling:998     * <pre><code class='java'> withEqualsForFields(idBiPredicate, "foo.id", "foo.bar.id")</code></pre>999     * <p>1000     * BiPredicates registered with this method have precedence over the ones registered with {@link #withEqualsForType(BiPredicate, Class)}1001     * or the comparators registered with {@link #withComparatorForType(Comparator, Class)}.1002     * <p>1003     * Note that registering a {@link BiPredicate} for a given field will override the previously registered BiPredicate/Comparator (if any).1004     * <p>1005     * See {@link RecursiveComparisonAssert#withEqualsForFields(BiPredicate, String...) RecursiveComparisonAssert#withEqualsForFields(BiPredicate equals, String...fields)} for examples.1006     *1007     * @param equals the {@link BiPredicate} to use to compare the given fields1008     * @param fields the fields the BiPredicate should be used for1009     * @return this builder.1010     * @since 3.17.01011     * @throws NullPointerException if the given BiPredicate is null.1012     */1013    public Builder withEqualsForFields(BiPredicate<?, ?> equals, String... fields) {1014      return withComparatorForFields(toComparator(equals), fields);1015    }1016    public RecursiveComparisonConfiguration build() {1017      return new RecursiveComparisonConfiguration(this);1018    }1019  }...

Source:RecursiveComparisonAssert_isEqualTo_BaseTest.java

...18import org.assertj.core.api.recursive.comparison.ComparisonDifference;19import org.assertj.core.api.recursive.comparison.RecursiveComparisonConfiguration;20import org.assertj.core.internal.ObjectsBaseTest;21import org.junit.jupiter.api.BeforeEach;22public class RecursiveComparisonAssert_isEqualTo_BaseTest extends ObjectsBaseTest {23  public static WritableAssertionInfo info;24  public RecursiveComparisonConfiguration recursiveComparisonConfiguration;25  @BeforeEach26  public void setup() {27    recursiveComparisonConfiguration = new RecursiveComparisonConfiguration();28  }29  public void verifyShouldBeEqualByComparingFieldByFieldRecursivelyCall(Object actual, Object expected,30                                                                        ComparisonDifference... differences) {31    verify(failures).failure(info, shouldBeEqualByComparingFieldByFieldRecursively(actual,32                                                                                   expected,33                                                                                   list(differences),34                                                                                   recursiveComparisonConfiguration,35                                                                                   info.representation()));36  }37  public AssertionError compareRecursivelyFailsAsExpected(Object actual, Object expected) {38    RecursiveComparisonAssert<?> recursiveComparisonAssert = new RecursiveComparisonAssert<>(actual,39                                                                                             recursiveComparisonConfiguration);40    info = recursiveComparisonAssert.info;41    recursiveComparisonAssert.objects = objects;42    return expectAssertionError(() -> recursiveComparisonAssert.isEqualTo(expected));43  }44  public static ComparisonDifference diff(String path, Object actual, Object other) {45    return new ComparisonDifference(list(path), actual, other);46  }47  public static ComparisonDifference diff(String path, Object actual, Object other, String additionalInformation) {48    return new ComparisonDifference(list(path), actual, other, additionalInformation);49  }50}...

Source:TestMatcher.java

1package com.zhinkoilya1993.backend;2import org.assertj.core.api.RecursiveComparisonAssert;3import org.springframework.test.web.servlet.ResultMatcher;4import java.util.List;5import static com.zhinkoilya1993.backend.util.TestUtil.readListFromJsonMvcResult;6import static org.assertj.core.api.Assertions.assertThat;7public class TestMatcher<T> {8    private final String[] fieldsToIgnore;9    private final boolean usingEquals;10    private final Class<T> clazz;11    private TestMatcher(boolean usingEquals, Class<T> clazz, String... fieldsToIgnore) {12        this.fieldsToIgnore = fieldsToIgnore;13        this.usingEquals = usingEquals;14        this.clazz = clazz;15    }16    public static <T> TestMatcher<T> fieldsComparorOf(Class<T> clazz) {17        return new TestMatcher<>(true, clazz);18    }19    public static <T> TestMatcher<T> fieldsComparorOf(Class<T> clazz, String... fieldsToIgnore) {20        return new TestMatcher<>(false, clazz, fieldsToIgnore);21    }22    public void assertMatch(T actual, T expected) {23        RecursiveComparisonAssert<?> recursiveComparison = assertThat(actual)24                .usingRecursiveComparison();25        if (!usingEquals) {26            recursiveComparison = recursiveComparison.ignoringFields(fieldsToIgnore);27        }28        recursiveComparison.isEqualTo(expected);29    }30    @SafeVarargs31    public final void assertMatch(Iterable<T> actual, T... expected) {32        assertMatch(actual, List.of(expected));33    }34    public void assertMatch(Iterable<T> actual, Iterable<T> expected) {35        RecursiveComparisonAssert<?> recursiveComparison = assertThat(actual)36                .usingRecursiveComparison();37        if (!usingEquals) {38            recursiveComparison = recursiveComparison.ignoringFields(fieldsToIgnore);39        }40        recursiveComparison.isEqualTo(expected);41    }42    public ResultMatcher contentJson(T expected) {43        return result -> assertMatch(readListFromJsonMvcResult(result, clazz), expected);44    }45    public ResultMatcher contentJson(T... expected) {46        return contentJson(List.of(expected));47    }48    public ResultMatcher contentJson(Iterable<T> expected) {49        return result -> assertMatch(readListFromJsonMvcResult(result, clazz), expected);...

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.Assertions;2import org.assertj.core.api.RecursiveComparisonAssert;3import org.assertj.core.api.RecursiveComparisonConfiguration;4import org.assertj.core.api.RecursiveComparisonConfigurationBuilder;5import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitives;6import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArrays;7import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesArraysAndCollections;8import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndCollections;9import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForArrays;10import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndCollections;11import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndCollectionsAndArrays;12import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForArraysAndPrimitives;13import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForArraysAndCollections;14import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForArraysAndPrimitivesAndCollections;15import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForCollections;16import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndCollectionsAndArraysAndCollections;17import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndCollectionsAndArrays;18import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndPrimitivesAndCollections;19import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndPrimitivesAndArrays;20import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndPrimitivesAndArraysAndCollections;21import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndPrimitivesAndCollectionsAndArrays;22import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndPrimitivesAndCollectionsAndArraysAndCollections;23import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPrimitivesAndArraysAndCollectionsAndPrimitives;24import org.assertj.core.api.RecursiveComparisonConfigurationBuilder.RecursiveComparisonConfigurationBuilderForPr

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.RecursiveComparisonAssert;2import org.assertj.core.api.RecursiveComparisonConfiguration;3import org.assertj.core.api.Assertions;4public class RecursiveComparisonAssertExample {5    public static void main(String[] args) {6        RecursiveComparisonConfiguration configuration = RecursiveComparisonConfiguration.builder()7                .withIgnoredFields("id")8                .build();9        RecursiveComparisonAssert.assertThat(new Person("John", 27))10                .usingRecursiveComparison(configuration)11                .isEqualTo(new Person("John", 27));12    }13    static class Person {14        private String name;15        private int age;16        public Person(String name, int age) {17            this.name = name;18            this.age = age;19        }20        public String getName() {21            return name;22        }23        public int getAge() {24            return age;25        }26    }27}28AssertJ | RecursiveComparisonAssert usingRecursiveComparison() method29AssertJ | RecursiveComparisonAssert ignoringFields() method30AssertJ | RecursiveComparisonAssert ignoringAllOverriddenEqualsForTypes() method31AssertJ | RecursiveComparisonAssert ignoringAllActualNullFields() method32AssertJ | RecursiveComparisonAssert ignoringAllNullFields() method33AssertJ | RecursiveComparisonAssert ignoringFieldsOfTypes() method34AssertJ | RecursiveComparisonAssert ignoringFieldsMatchingRegexes() method35AssertJ | RecursiveComparisonAssert ignoringFieldsMatchingRegexes() method36AssertJ | RecursiveComparisonAssert ignoringCollectionOrder() method

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.RecursiveComparisonAssert;2import org.assertj.core.api.AbstractAssert;3import org.assertj.core.api.Assertions;4import org.assertj.core.api.RecursiveComparisonAssert;5import org.assertj.core.api.RecursiveComparisonConfiguration;6import org.assertj.core.api.RecursiveComparisonConfigurationBuilder;7import org.assertj.core.api.RecursiveComparisonDifference;8import org.assertj.core.api.RecursiveComparisonDiffere

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.RecursiveComparisonAssert;2public class 1 {3    public static void main(String args[]) {4        RecursiveComparisonAssert recursiveComparisonAssert = new RecursiveComparisonAssert();5        recursiveComparisonAssert.isEqualTo();6    }7}8public static void main(String[] args)

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.RecursiveComparisonAssert;2class RecursiveComparisonAssertTest {3  public static void main(String[] args) {4    RecursiveComparisonAssertTest obj = new RecursiveComparisonAssertTest();5    obj.test();6  }7  void test() {8    RecursiveComparisonAssert obj = new RecursiveComparisonAssert("test");9    obj.isEqualTo("test");10  }11}12    RecursiveComparisonAssert obj = new RecursiveComparisonAssert("test");13    obj.isEqualTo("test");14  symbol:   method isEqualTo(String)

RecursiveComparisonAssert

Using AI Code Generation

1import org.assertj.core.api.RecursiveComparisonAssert;2import org.assertj.core.api.Assertions;3import java.util.ArrayList;4public class RecursiveComparisonAssertTest {5   public static void main(String[] args) {6      ArrayList<String> al = new ArrayList<String>();7      al.add("Java");8      al.add("Python");9      al.add("C++");10      al.add("C");11      al.add("Ruby");12      ArrayList<String> al2 = new ArrayList<String>();13      al2.add("Java");14      al2.add("Python");15      al2.add("C++");16      al2.add("C");17      al2.add("Ruby");18      RecursiveComparisonAssert<Object> rca = Assertions.assertThat(al);19      rca.isEqualTo(al2);20      System.out.println("Both ArrayList objects are equal.");21   }22}23Recommended Posts: Java | assertThrows() method24Java | assertTimeout() method25Java | assertTimeoutPreemptively() method26Java | assertArrayEquals() method27Java | assertDoesNotThrow() method28Java | assertNotEquals() method29Java | assertSame() method30Java | assertNotSame() method31Java | assertNotNull() method32Java | assertNull() method33Java | assertTrue() method34Java | assertFalse() method35Java | assertEquals() method36Java | assertNotSame() method37Java | assertSame() method38Java | assertArrayEquals() method39Java | assertTimeoutPreemptively() method40Java | assertTimeout() method41Java | assertThrows() method42Java | assertDoesNotThrow() method43Java | assertNotEquals() method44Java | assertNotNull() method45Java | assertNull() method46Java | assertTrue() method47Java | assertFalse() method48Java | assertEquals() method49Java | assertAll() method50Java | assertIterableEquals() method51Java | assertLinesMatch() method52Java | assertTimeoutPreemptively() method53Java | assertTimeout() method54Java | assertThrows() method

Automation Testing Tutorials

Learn to execute automation testing from scratch with LambdaTest Learning Hub. Right from setting up the prerequisites to run your first automation test, to following best practices and diving deeper into advanced test scenarios. LambdaTest Learning Hubs compile a list of step-by-step guides to help you be proficient with different test automation frameworks i.e. Selenium, Cypress, TestNG etc.