/*
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 *
 * Copyright 2012-2021 the original author or authors.
 */
package org.assertj.core.internal;

import static org.assertj.core.configuration.ConfigurationProvider.CONFIGURATION_PROVIDER;
import static org.assertj.core.internal.TypeComparators.defaultTypeComparators;

import java.util.Comparator;
import java.util.HashMap;
import java.util.Map;

import org.assertj.core.util.VisibleForTesting;
import org.assertj.core.util.introspection.IntrospectionError;

@Deprecated
public class IgnoringFieldsComparator extends FieldByFieldComparator {

  private final String[] fields;

  public IgnoringFieldsComparator(Map<String, Comparator<?>> comparatorByPropertyOrField,
                                  TypeComparators comparatorByType, String... fields) {
    super(comparatorByPropertyOrField, comparatorByType);
    this.fields = fields;
  }

  public IgnoringFieldsComparator(String... fields) {
    this(new HashMap<>(), defaultTypeComparators(), fields);
  }

  @VisibleForTesting
  public String[] getFields() {
    return fields;
  }

  @Override
  protected boolean areEqual(Object actualElement, Object otherElement) {
    try {
      return Objects.instance().areEqualToIgnoringGivenFields(actualElement, otherElement, comparatorsByPropertyOrField,
                                                              comparatorsByType, fields);
    } catch (IntrospectionError e) {
      return false;
    }
  }

  @Override
  protected String description() {
    return "field/property by field/property comparator on all fields/properties except "
           + CONFIGURATION_PROVIDER.representation().toStringOf(fields);
  }
}

@@ -914,95 +914,709 @@
 ore.
-util.VisibleForTesting;%0Aimport org.assertj.core.util.introspection.IntrospectionError;%0A
+api.AbstractIterableAssert;%0Aimport org.assertj.core.api.AbstractObjectAssert;%0Aimport org.assertj.core.api.recursive.comparison.RecursiveComparisonConfiguration;%0Aimport org.assertj.core.util.VisibleForTesting;%0Aimport org.assertj.core.util.introspection.IntrospectionError;%0A%0A/**%0A * @deprecated%0A * This comparator is deprecated because it performs a %3Cb%3Eshallow%3C/b%3E field by field comparison, i.e. elements are compared%0A * field by field but the fields are compared with equals, use %7B@link AbstractIterableAssert#usingRecursiveFieldByFieldElementComparator(RecursiveComparisonConfiguration)%7D%0A * or %7B@link AbstractObjectAssert#usingRecursiveComparison()%7D instead to perform a true recursive comparison.%0A */
 %0A@De

Fix sonar issue complaining about the missing deprecated javadoc