package org.opentrafficsim.road.network.speed;
   
   import java.io.Serializable;
   import java.util.LinkedHashMap;
   import java.util.Map;
   
   import org.djutils.exceptions.Throw;
   
   /**
   * Class to contain speed info related to various speed limit types. Instances can reflect the current speed limit situation,
   * some situation ahead, or some situation in the past.
   * <p>
   * Copyright (c) 2013-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
   * BSD-style license. See <a href="https://opentrafficsim.org/docs/license.html">OpenTrafficSim License</a>.
   * </p>
   * @author <a href="https://github.com/averbraeck">Alexander Verbraeck</a>
   * @author <a href="https://github.com/wjschakel">Wouter Schakel</a>
   */
  
  public class SpeedLimitInfo implements Serializable
  {
  
      /** */
      private static final long serialVersionUID = 20160501L;
  
      /** Set of current speed info's mapped to speed limit types. */
      private final Map<SpeedLimitType<?>, Object> speedInfoMap = new LinkedHashMap<>();
  
      /**
       * Adds or overwrites the speed info of the given speed limit type.
       * @param speedLimitType SpeedLimitType&lt;T&gt;; speed limit type to add info for
       * @param speedInfo T; info regarding the speed limit type
       * @param <T> class of speed info
       * @throws NullPointerException if the speed limit type or speed info is null
       */
      public final <T> void addSpeedInfo(final SpeedLimitType<T> speedLimitType, final T speedInfo)
      {
          Throw.whenNull(speedLimitType, "Speed limit type may not be null.");
          Throw.whenNull(speedInfo, "Speed info may not be null.");
          this.speedInfoMap.put(speedLimitType, speedInfo);
      }
  
      /**
       * Removes the speed info of given speed limit type.
       * @param speedLimitType SpeedLimitType&lt;?&gt;; speed limit type of speed info to remove
       * @throws NullPointerException if the speed limit type is null
       */
      public final void removeSpeedInfo(final SpeedLimitType<?> speedLimitType)
      {
          Throw.whenNull(speedLimitType, "Speed limit type may not be null.");
          this.speedInfoMap.remove(speedLimitType);
      }
  
      /**
       * Whether speed info is present for the given speed limit type.
       * @param speedLimitType SpeedLimitType&lt;?&gt;; speed limit type
       * @return whether speed info is present for the given speed limit type
       */
      public final boolean containsType(final SpeedLimitType<?> speedLimitType)
      {
          return this.speedInfoMap.containsKey(speedLimitType);
      }
  
      /**
       * Returns the info regarding a specific speed limit type.
       * @param speedLimitType SpeedLimitType&lt;T&gt;; speed limit type to return info for
       * @param <T> class of speed limit type info
       * @return the speed limit type info
       * @throws NullPointerException if the speed limit type is null
       * @throws IllegalStateException if the speed limit type is not present
       */
      @SuppressWarnings("unchecked")
      public final <T> T getSpeedInfo(final SpeedLimitType<T> speedLimitType)
      {
          Throw.whenNull(speedLimitType, "Speed limit type may not be null.");
          Throw.when(!containsType(speedLimitType), IllegalStateException.class,
                  "The speed limit type '%s' "
                          + "is not present in the speed limit info. Use SpeedLimitInfo.containsType() to check.",
                  speedLimitType.getId());
          return (T) this.speedInfoMap.get(speedLimitType);
      }
  
      /** {@inheritDoc} */
      @Override
      public final int hashCode()
      {
          final int prime = 31;
          int result = 1;
          result = prime * result + this.speedInfoMap.hashCode();
          return result;
      }
  
      /** {@inheritDoc} */
      @Override
      public final boolean equals(final Object obj)
      {
          if (this == obj)
          {
              return true;
         }
         if (obj == null)
         {
             return false;
         }
         if (getClass() != obj.getClass())
         {
             return false;
         }
         SpeedLimitInfo other = (SpeedLimitInfo) obj;
         if (!this.speedInfoMap.equals(other.speedInfoMap))
         {
             return false;
         }
         return true;
     }
 
     /** {@inheritDoc} */
     @Override
     public final String toString()
     {
         StringBuilder stringBuilder = new StringBuilder("SpeedLimitInfo [");
         String sep = "";
         for (SpeedLimitType<?> slt : this.speedInfoMap.keySet())
         {
             stringBuilder.append(sep);
             stringBuilder.append(slt.getId());
             stringBuilder.append("=");
             stringBuilder.append(this.speedInfoMap.get(slt));
             sep = ", ";
         }
         stringBuilder.append("]");
         return stringBuilder.toString();
     }
 
 }