// =================== 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 with().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 with().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 with().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 )
                 
               
 }