// =================== DO NOT EDIT THIS FILE ====================
   //  Generated by Modello Velocity from model.vm
   //  template, any modifications will be overwritten.
   // ==============================================================
   package org.apache.maven.api.toolchain;
   
   import java.io.Serializable;
   import java.util.Collections;
   import java.util.HashMap;
  import java.util.Map;
  import org.apache.maven.api.annotations.Experimental;
  import org.apache.maven.api.annotations.Generated;
  import org.apache.maven.api.annotations.Immutable;
  import org.apache.maven.api.annotations.Nonnull;
  import org.apache.maven.api.annotations.NotThreadSafe;
  import org.apache.maven.api.annotations.ThreadSafe;
  import org.apache.maven.api.xml.XmlNode;
  
  /**
   * Definition of a toolchain instance.
   */
  @Experimental
  @Generated @ThreadSafe @Immutable
  public class ToolchainModel
      extends TrackableBase
      implements Serializable
  {
      /**
       * Type of toolchain:<ul>
       * <li><code>jdk</code> for
       * <a href="https://maven.apache.org/plugins/maven-toolchains-plugin/toolchains/jdk.html">JDK Standard Toolchain</a>,</li>
       * <li>other value for
       * <a href="https://maven.apache.org/plugins/maven-toolchains-plugin/toolchains/custom.html">Custom Toolchain</a></li>
       * </ul>
       */
      final String type;
      /**
       * <p>Toolchain identification information, which will be matched against project requirements.</p>
       * <p>For Maven 2.0.9 to 3.2.3, the actual content structure was completely open: each toolchain type would define its own format and semantics.
       * In general, this was a properties format.</p>
       * <p>Since Maven 3.2.4, the type for this field has been changed to Properties to match the de-facto format.</p>
       * <p>Each toolchain defines its own properties names and semantics.</p>
       */
      final Map<String, String> provides;
      /**
       * <p>Toolchain configuration information, like location or any information that is to be retrieved.</p>
       * <p>Actual content structure is completely open: each toolchain type will define its own format and semantics.</p>
       * <p>In general, this is a properties format: <code>&lt;name&gt;value&lt;/name&gt;</code> with
       * per-toolchain defined properties names.</p>
       */
      final XmlNode configuration;
  
      /**
        * Constructor for this class, package protected.
        * @see Builder#build()
        */
      ToolchainModel(
          String type,
          Map<String, String> provides,
          XmlNode configuration
      ) {
          super(
          );
          this.type = type;
          this.provides = ImmutableCollections.copy(provides);
          this.configuration = configuration;
      }
  
      /**
       * Type of toolchain:<ul>
       * <li><code>jdk</code> for
       * <a href="https://maven.apache.org/plugins/maven-toolchains-plugin/toolchains/jdk.html">JDK Standard Toolchain</a>,</li>
       * <li>other value for
       * <a href="https://maven.apache.org/plugins/maven-toolchains-plugin/toolchains/custom.html">Custom Toolchain</a></li>
       * </ul>
       *
       * @return a {@code String}
       */
      public String getType() {
          return this.type;
      }
  
      /**
       * <p>Toolchain identification information, which will be matched against project requirements.</p>
       * <p>For Maven 2.0.9 to 3.2.3, the actual content structure was completely open: each toolchain type would define its own format and semantics.
       * In general, this was a properties format.</p>
       * <p>Since Maven 3.2.4, the type for this field has been changed to Properties to match the de-facto format.</p>
       * <p>Each toolchain defines its own properties names and semantics.</p>
       *
       * @return a {@code Map<String, String>}
       */
      @Nonnull
      public Map<String, String> getProvides() {
          return this.provides;
      }
  
      /**
       * <p>Toolchain configuration information, like location or any information that is to be retrieved.</p>
       * <p>Actual content structure is completely open: each toolchain type will define its own format and semantics.</p>
      * <p>In general, this is a properties format: <code>&lt;name&gt;value&lt;/name&gt;</code> with
      * per-toolchain defined properties names.</p>
      *
      * @return a {@code XmlNode}
      */
     public XmlNode getConfiguration() {
         return this.configuration;
     }
 
     /**
      * Creates a new builder with this object as the basis.
      *
      * @return a {@code Builder}
      */
     @Nonnull
     public Builder with() {
         return newBuilder(this);
     }
     /**
      * Creates a new {@code ToolchainModel} instance using the specified type.
      *
      * @param type the new {@code String} to use
      * @return a {@code ToolchainModel} with the specified type
      */
     @Nonnull
     public ToolchainModel withType(String type) {
         return newBuilder(this, true).type(type).build();
     }
     /**
      * Creates a new {@code ToolchainModel} instance using the specified provides.
      *
      * @param provides the new {@code Map<String, String>} to use
      * @return a {@code ToolchainModel} with the specified provides
      */
     @Nonnull
     public ToolchainModel withProvides(Map<String, String> provides) {
         return newBuilder(this, true).provides(provides).build();
     }
     /**
      * Creates a new {@code ToolchainModel} instance using the specified configuration.
      *
      * @param configuration the new {@code XmlNode} to use
      * @return a {@code ToolchainModel} with the specified configuration
      */
     @Nonnull
     public ToolchainModel withConfiguration(XmlNode configuration) {
         return newBuilder(this, true).configuration(configuration).build();
     }
 
     /**
      * Creates a new {@code ToolchainModel} instance.
      * Equivalent to {@code newInstance(true)}.
      * @see #newInstance(boolean)
      *
      * @return a new {@code ToolchainModel}
      */
     @Nonnull
     public static ToolchainModel newInstance() {
         return newInstance(true);
     }
 
     /**
      * Creates a new {@code ToolchainModel} instance using default values or not.
      * Equivalent to {@code newBuilder(withDefaults).build()}.
      *
      * @param withDefaults the boolean indicating whether default values should be used
      * @return a new {@code ToolchainModel}
      */
     @Nonnull
     public static ToolchainModel newInstance(boolean withDefaults) {
         return newBuilder(withDefaults).build();
     }
 
     /**
      * Creates a new {@code ToolchainModel} builder instance.
      * Equivalent to {@code newBuilder(true)}.
      * @see #newBuilder(boolean)
      *
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder() {
         return newBuilder(true);
     }
 
     /**
      * Creates a new {@code ToolchainModel} builder instance using default values or not.
      *
      * @param withDefaults the boolean indicating whether default values should be used
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(boolean withDefaults) {
         return new Builder(withDefaults);
     }
 
     /**
      * Creates a new {@code ToolchainModel} builder instance using the specified object as a basis.
      * Equivalent to {@code newBuilder(from, false)}.
      *
      * @param from the {@code ToolchainModel} instance to use as a basis
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(ToolchainModel from) {
         return newBuilder(from, false);
     }
 
     /**
      * Creates a new {@code ToolchainModel} builder instance using the specified object as a basis.
      *
      * @param from the {@code ToolchainModel} instance to use as a basis
      * @param forceCopy the boolean indicating if a copy should be forced
      * @return a new {@code Builder}
      */
     @Nonnull
     public static Builder newBuilder(ToolchainModel from, boolean forceCopy) {
         return new Builder(from, forceCopy);
     }
 
     /**
      * Builder class used to create ToolchainModel instances.
      * @see #with()
      * @see #newBuilder()
      */
     @NotThreadSafe
     public static class Builder
         extends TrackableBase.Builder
     {
         ToolchainModel base;
         String type;
         Map<String, String> provides;
         XmlNode configuration;
 
         Builder(boolean withDefaults) {
             super(withDefaults);
             if (withDefaults) {
             }
         }
 
         Builder(ToolchainModel base, boolean forceCopy) {
             super(base, forceCopy);
             if (forceCopy) {
                 this.type = base.type;
                 this.provides = base.provides;
                 this.configuration = base.configuration;
             } else {
                 this.base = base;
             }
         }
 
         @Nonnull
         public Builder type(String type) {
             this.type = type;
             return this;
         }
 
         @Nonnull
         public Builder provides(Map<String, String> provides) {
             this.provides = provides;
             return this;
         }
 
         @Nonnull
         public Builder configuration(XmlNode configuration) {
             this.configuration = configuration;
             return this;
         }
 
 
         @Nonnull
         public ToolchainModel build() {
             if (base != null
                     && (type == null || type == base.type)
                     && (provides == null || provides == base.provides)
                     && (configuration == null || configuration == base.configuration)
             ) {
                 return base;
             }
             return new ToolchainModel(
                 type != null ? type : (base != null ? base.type : null),
                 provides != null ? provides : (base != null ? base.provides : null),
                 configuration != null ? configuration : (base != null ? base.configuration : null)
             );
         }
     }
 
 
                 
     /**
      * Method hashCode.
      *
      * @return int
      */
     public int hashCode()
     {
         int result = 17;
 
         result = 37 * result + ( getType() != null ? getType().hashCode() : 0 );
         result = 37 * result + ( getProvides() != null ? getProvides().hashCode() : 0 );
 
         return result;
     } //-- int hashCode()
 
     /**
      * Method equals.
      *
      * @param other
      * @return boolean
      */
     public boolean equals( Object other )
     {
         if ( this == other )
         {
             return true;
         }
 
         if ( !( other instanceof ToolchainModel ) )
         {
             return false;
         }
 
         ToolchainModel that = (ToolchainModel) other;
         boolean result = true;
 
         result = result && ( getType() == null ? that.getType() == null : getType().equals( that.getType() ) );
         result = result && ( getProvides() == null ? that.getProvides() == null : getProvides().equals( that.getProvides() ) );
 
         return result;
     } //-- boolean equals( Object )
                 
               
 }