/*
    * SPDX-FileCopyrightText: none
    * SPDX-License-Identifier: CC0-1.0
    */
   
   package dev.metaschema.core.model.constraint.impl;
   
   import java.util.List;
   import java.util.Map;
  import java.util.Set;
  
  import dev.metaschema.core.datatype.markup.MarkupLine;
  import dev.metaschema.core.datatype.markup.MarkupMultiline;
  import dev.metaschema.core.metapath.IMetapathExpression;
  import dev.metaschema.core.model.IAttributable;
  import dev.metaschema.core.model.ISource;
  import dev.metaschema.core.model.constraint.ConstraintInitializationException;
  import dev.metaschema.core.model.constraint.IConstraint;
  import dev.metaschema.core.model.constraint.IIndexHasKeyConstraint;
  import dev.metaschema.core.model.constraint.IKeyField;
  import edu.umd.cs.findbugs.annotations.NonNull;
  import edu.umd.cs.findbugs.annotations.Nullable;
  
  /**
   * Represents a key reference constraint.
   * <p>
   * Uses a set of key fields to build a key to match against an index. A Match is
   * successful if the resulting key matches an entry in the index.
   */
  public final class DefaultIndexHasKeyConstraint
      extends AbstractKeyConstraint
      implements IIndexHasKeyConstraint {
    @NonNull
    private final String indexName;
  
    /**
     * Construct a key reference constraint.
     *
     * @param id
     *          the optional identifier for the constraint
     * @param formalName
     *          the constraint's formal indexName or {@code null} if not provided
     * @param description
     *          the constraint's semantic description or {@code null} if not
     *          provided
     * @param source
     *          information about the constraint source
     * @param level
     *          the significance of a violation of this constraint
     * @param target
     *          the Metapath expression identifying the nodes the constraint targets
     * @param properties
     *          a collection of associated properties
     * @param indexName
     *          a reference to the indexName of the index
     * @param keyFields
     *          a list of key fields associated with the constraint
     * @param message
     *          an optional message to emit when the constraint is violated
     * @param remarks
     *          optional remarks describing the intent of the constraint
     */
    @SuppressWarnings("PMD.ExcessiveParameterList")
    public DefaultIndexHasKeyConstraint(
        @Nullable String id,
        @Nullable String formalName,
        @Nullable MarkupLine description,
        @NonNull ISource source,
        @NonNull Level level,
        @NonNull IMetapathExpression target,
        @NonNull Map<IAttributable.Key, Set<String>> properties,
        @NonNull String indexName,
        @NonNull List<IKeyField> keyFields,
        @Nullable String message,
        @Nullable MarkupMultiline remarks) {
      super(id, formalName, description, source, level, target, properties, keyFields, message, remarks);
      if (indexName.isBlank()) {
        throw new ConstraintInitializationException(
            String.format("The index indexName must be a non-blank string in the constraint %s in '%s'",
                IConstraint.getConstraintIdentity(this),
                source.getLocationHint()));
      }
      this.indexName = indexName;
    }
  
    @Override
    public String getIndexName() {
      return indexName;
    }
  
  }