/*
    * SPDX-FileCopyrightText: none
    * SPDX-License-Identifier: CC0-1.0
    */
   // Generated from: ../../../../../../metaschema/unit-tests.yaml
   // Do not edit - changes will be lost when regenerated.
   
   package dev.metaschema.model.testing.testsuite;
   
  import org.apache.commons.lang3.builder.ReflectionToStringBuilder;
  import org.apache.commons.lang3.builder.ToStringStyle;
  
  import java.net.URI;
  import java.util.LinkedList;
  import java.util.List;
  
  import dev.metaschema.core.datatype.adapter.StringAdapter;
  import dev.metaschema.core.datatype.adapter.UriReferenceAdapter;
  import dev.metaschema.core.model.IBoundObject;
  import dev.metaschema.core.model.IMetaschemaData;
  import dev.metaschema.core.model.JsonGroupAsBehavior;
  import dev.metaschema.core.util.ObjectUtils;
  import dev.metaschema.databind.model.annotations.BoundAssembly;
  import dev.metaschema.databind.model.annotations.BoundFlag;
  import dev.metaschema.databind.model.annotations.GroupAs;
  import dev.metaschema.databind.model.annotations.MetaschemaAssembly;
  import edu.umd.cs.findbugs.annotations.NonNull;
  
  /**
   * A collection of test scenarios located at a specific path.
   */
  @MetaschemaAssembly(
      formalName = "Test Collection",
      description = "A collection of test scenarios located at a specific path.",
      name = "test-collection",
      moduleClass = MetaschemaTestSuiteModule.class)
  public class TestCollection implements IBoundObject {
    private final IMetaschemaData __metaschemaData;
  
    /**
     * A URI reference to the location of this test collection.
     */
    @BoundFlag(
        formalName = "Location",
        description = "A URI reference to the location of this test collection.",
        name = "location",
        required = true,
        typeAdapter = UriReferenceAdapter.class)
    private URI _location;
  
    /**
     * The name of this test collection.
     */
    @BoundFlag(
        formalName = "Name",
        description = "The name of this test collection.",
        name = "name",
        required = true,
        typeAdapter = StringAdapter.class)
    private String _name;
  
    /**
     * A test scenario that validates a metaschema and its content.
     */
    @BoundAssembly(
        formalName = "Test Scenario",
        description = "A test scenario that validates a metaschema and its content.",
        useName = "test-scenario",
        minOccurs = 1,
        maxOccurs = -1,
        groupAs = @GroupAs(name = "test-scenarios", inJson = JsonGroupAsBehavior.LIST))
    private List<TestScenario> _testScenarios;
  
    /**
     * Constructs a new
     * {@code dev.metaschema.model.testing.testsuite.TestCollection} instance with
     * no metadata.
     */
    public TestCollection() {
      this(null);
    }
  
    /**
     * Constructs a new
     * {@code dev.metaschema.model.testing.testsuite.TestCollection} instance with
     * the specified metadata.
     *
     * @param data
     *          the metaschema data, or {@code null} if none
     */
    public TestCollection(IMetaschemaData data) {
      this.__metaschemaData = data;
    }
  
    @Override
    public IMetaschemaData getMetaschemaData() {
      return __metaschemaData;
    }
  
   /**
    * Get the location.
    *
    * <p>
    * A URI reference to the location of this test collection.
    *
    * @return the location value
    */
   @NonNull
   public URI getLocation() {
     return _location;
   }
 
   /**
    * Set the location.
    *
    * <p>
    * A URI reference to the location of this test collection.
    *
    * @param value
    *          the location value to set
    */
   public void setLocation(@NonNull URI value) {
     _location = value;
   }
 
   /**
    * Get the name.
    *
    * <p>
    * The name of this test collection.
    *
    * @return the name value
    */
   @NonNull
   public String getName() {
     return _name;
   }
 
   /**
    * Set the name.
    *
    * <p>
    * The name of this test collection.
    *
    * @param value
    *          the name value to set
    */
   public void setName(@NonNull String value) {
     _name = value;
   }
 
   /**
    * Get the test Scenario.
    *
    * <p>
    * A test scenario that validates a metaschema and its content.
    *
    * @return the test-scenario value
    */
   @NonNull
   public List<TestScenario> getTestScenarios() {
     if (_testScenarios == null) {
       _testScenarios = new LinkedList<>();
     }
     return ObjectUtils.notNull(_testScenarios);
   }
 
   /**
    * Set the test Scenario.
    *
    * <p>
    * A test scenario that validates a metaschema and its content.
    *
    * @param value
    *          the test-scenario value to set
    */
   public void setTestScenarios(@NonNull List<TestScenario> value) {
     _testScenarios = value;
   }
 
   /**
    * Add a new {@link TestScenario} item to the underlying collection.
    *
    * @param item
    *          the item to add
    * @return {@code true}
    */
   public boolean addTestScenario(TestScenario item) {
     TestScenario value = ObjectUtils.requireNonNull(item, "item cannot be null");
     if (_testScenarios == null) {
       _testScenarios = new LinkedList<>();
     }
     return _testScenarios.add(value);
   }
 
   /**
    * Remove the first matching {@link TestScenario} item from the underlying
    * collection.
    *
    * @param item
    *          the item to remove
    * @return {@code true} if the item was removed or {@code false} otherwise
    */
   public boolean removeTestScenario(TestScenario item) {
     TestScenario value = ObjectUtils.requireNonNull(item, "item cannot be null");
     return _testScenarios != null && _testScenarios.remove(value);
   }
 
   @Override
   public String toString() {
     return ObjectUtils.notNull(new ReflectionToStringBuilder(this, ToStringStyle.MULTI_LINE_STYLE).toString());
   }
 }