Klasse ImmutableObject2ObjectOpenHashMap<T,V>

java.lang.Object
java.util.AbstractMap<T,V>
speiger.src.collections.objects.maps.abstracts.AbstractObject2ObjectMap<T,V>
speiger.src.collections.objects.maps.impl.immutable.ImmutableObject2ObjectOpenHashMap<T,V>
Typparameter:
T - the keyType of elements maintained by this Collection
V - the keyType of elements maintained by this Collection
Alle implementierten Schnittstellen:
Function<T,V>, Map<T,V>, UnaryOperator<T,V>, Object2ObjectMap<T,V>, Object2ObjectOrderedMap<T,V>

public class ImmutableObject2ObjectOpenHashMap<T,V> extends AbstractObject2ObjectMap<T,V> implements Object2ObjectOrderedMap<T,V>
A Type Specific Custom implementation of the HashMap Instead of using Wrapper Object Arrays for storing keys and values there is dedicated arrays for storing keys and values. Extra to that there is a couple quality of life functions provided
  • Konstruktordetails

    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(T[] keys, V[] values)
      Helper constructor that allow to create a map from unboxed values
      Parameter:
      keys - the keys that should be put into the map
      values - the values that should be put into the map.
      Löst aus:
      IllegalStateException - if the keys and values do not match in lenght
    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(T[] keys, V[] values, float loadFactor)
      Helper constructor that allow to create a map from unboxed values
      Parameter:
      keys - the keys that should be put into the map
      values - the values that should be put into the map.
      loadFactor - the percentage of how full the backing array can be before they resize
      Löst aus:
      IllegalStateException - if the keys and values do not match in lenght
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(Map<? extends T,? extends V> map)
      A Helper constructor that allows to create a Map with exactly the same values as the provided map.
      Parameter:
      map - the values that should be present in the map
    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(Map<? extends T,? extends V> map, float loadFactor)
      A Helper constructor that allows to create a Map with exactly the same values as the provided map.
      Parameter:
      map - the values that should be present in the map
      loadFactor - the percentage of how full the backing array can be before they resize
      Löst aus:
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(Object2ObjectMap<T,V> map)
      A Type Specific Helper function that allows to create a new Map with exactly the same values as the provided map.
      Parameter:
      map - the values that should be present in the map
    • ImmutableObject2ObjectOpenHashMap

      public ImmutableObject2ObjectOpenHashMap(Object2ObjectMap<T,V> map, float loadFactor)
      A Type Specific Helper function that allows to create a new Map with exactly the same values as the provided map.
      Parameter:
      map - the values that should be present in the map
      loadFactor - the percentage of how full the backing array can be before they resize
      Löst aus:
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
  • Methodendetails

    • put

      public V put(T key, V value)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type Specific method to reduce boxing/unboxing of values
      Angegeben von:
      put in Schnittstelle Map<T,V>
      Angegeben von:
      put in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      put in Klasse AbstractMap<T,V>
      Parameter:
      key - the key that should be inserted,
      value - the value that should be inserted
      Gibt zurück:
      the last present value or default return value.
      Siehe auch:
    • putIfAbsent

      public V putIfAbsent(T key, V value)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type Specific method to reduce boxing/unboxing of values
      Angegeben von:
      putIfAbsent in Schnittstelle Map<T,V>
      Angegeben von:
      putIfAbsent in Schnittstelle Object2ObjectMap<T,V>
      Parameter:
      key - the key that should be inserted,
      value - the value that should be inserted
      Gibt zurück:
      the last present value or default return value.
      Siehe auch:
    • putAndMoveToFirst

      public V putAndMoveToFirst(T key, V value)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A customized put method that allows you to insert into the first index.
      Angegeben von:
      putAndMoveToFirst in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - the key that should be inserted
      value - the value that should be inserted
      Gibt zurück:
      the previous present or default return value
      Siehe auch:
    • putAndMoveToLast

      public V putAndMoveToLast(T key, V value)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A customized put method that allows you to insert into the last index. (This may be nessesary depending on the implementation)
      Angegeben von:
      putAndMoveToLast in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - the key that should be inserted
      value - the value that should be inserted
      Gibt zurück:
      the previous present or default return value
      Siehe auch:
    • moveToFirst

      public boolean moveToFirst(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A specific move method to move a given key/value to the first index.
      Angegeben von:
      moveToFirst in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - that should be moved to the first index
      Gibt zurück:
      true if the value was moved.
    • moveToLast

      public boolean moveToLast(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A specific move method to move a given key/value to the last index.
      Angegeben von:
      moveToLast in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - that should be moved to the first last
      Gibt zurück:
      true if the value was moved.
    • getAndMoveToFirst

      public V getAndMoveToFirst(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A Specific get method that allows to move teh given key/value int the first index.
      Angegeben von:
      getAndMoveToFirst in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - that is searched for
      Gibt zurück:
      the given value for the requested key or default return value
    • getAndMoveToLast

      public V getAndMoveToLast(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A Specific get method that allows to move teh given key/value int the last index.
      Angegeben von:
      getAndMoveToLast in Schnittstelle Object2ObjectOrderedMap<T,V>
      Parameter:
      key - that is searched for
      Gibt zurück:
      the given value for the requested key or default return value
    • containsKey

      public boolean containsKey(Object key)
      Angegeben von:
      containsKey in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      containsKey in Klasse AbstractObject2ObjectMap<T,V>
    • containsValue

      public boolean containsValue(Object value)
      Angegeben von:
      containsValue in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      containsValue in Klasse AbstractObject2ObjectMap<T,V>
    • rem

      public V rem(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type Specific remove function to reduce boxing/unboxing
      Angegeben von:
      rem in Schnittstelle Object2ObjectMap<T,V>
      Parameter:
      key - the element that should be removed
      Gibt zurück:
      the value that was removed or default return value
    • remOrDefault

      public V remOrDefault(T key, V defaultValue)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type-Specific Remove function with a default return value if wanted.
      Angegeben von:
      remOrDefault in Schnittstelle Object2ObjectMap<T,V>
      Parameter:
      key - the element that should be removed
      defaultValue - the value that should be returned if the entry doesn't exist
      Gibt zurück:
      the value that was removed or default value
      Siehe auch:
    • remove

      @Deprecated public V remove(Object key)
      Veraltet.
      Angegeben von:
      remove in Schnittstelle Map<T,V>
      Angegeben von:
      remove in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      remove in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the element that should be removed
      Gibt zurück:
      the value that was removed or default return value
      Siehe auch:
    • remove

      public boolean remove(Object key, Object value)
      Angegeben von:
      remove in Schnittstelle Map<T,V>
    • getObject

      public V getObject(T key)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific get method to reduce boxing/unboxing
      Angegeben von:
      getObject in Schnittstelle Object2ObjectMap<T,V>
      Parameter:
      key - the key that is searched for
      Gibt zurück:
      the searched value or default return value
    • get

      public V get(Object key)
      Angegeben von:
      get in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      get in Klasse AbstractObject2ObjectMap<T,V>
    • getOrDefault

      public V getOrDefault(Object key, V defaultValue)
      Angegeben von:
      getOrDefault in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      getOrDefault in Klasse AbstractObject2ObjectMap<T,V>
    • firstKey

      public T firstKey()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get the first Key of a Map.
      Angegeben von:
      firstKey in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the first key in the map
    • pollFirstKey

      public T pollFirstKey()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get and remove the first Key of a Map.
      Angegeben von:
      pollFirstKey in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the first key in the map
    • lastKey

      public T lastKey()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get the last Key of a Map.
      Angegeben von:
      lastKey in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the last key in the map
    • pollLastKey

      public T pollLastKey()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get and remove the last Key of a Map.
      Angegeben von:
      pollLastKey in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the last key in the map
    • firstValue

      public V firstValue()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get the first Value of a Map.
      Angegeben von:
      firstValue in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the first key in the map
    • lastValue

      public V lastValue()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectOrderedMap
      A method to get the last Value of a Map.
      Angegeben von:
      lastValue in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      the last key in the map
    • object2ObjectEntrySet

      public ObjectOrderedSet<Object2ObjectMap.Entry<T,V>> object2ObjectEntrySet()
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
      Angegeben von:
      object2ObjectEntrySet in Schnittstelle Object2ObjectMap<T,V>
      Angegeben von:
      object2ObjectEntrySet in Schnittstelle Object2ObjectOrderedMap<T,V>
      Gibt zurück:
      a EntrySet of the collection
    • keySet

      public ObjectOrderedSet<T> keySet()
      Angegeben von:
      keySet in Schnittstelle Map<T,V>
      Angegeben von:
      keySet in Schnittstelle Object2ObjectMap<T,V>
      Angegeben von:
      keySet in Schnittstelle Object2ObjectOrderedMap<T,V>
      Setzt außer Kraft:
      keySet in Klasse AbstractObject2ObjectMap<T,V>
    • values

      public ObjectCollection<V> values()
      Angegeben von:
      values in Schnittstelle Map<T,V>
      Angegeben von:
      values in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      values in Klasse AbstractObject2ObjectMap<T,V>
    • copy

      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Function that does a shallow clone of the Map itself. This function is more optimized then a copy constructor since the Map does not have to be unsorted/resorted. It can be compared to Cloneable but with less exception risk
      Angegeben von:
      copy in Schnittstelle Object2ObjectMap<T,V>
      Angegeben von:
      copy in Schnittstelle Object2ObjectOrderedMap<T,V>
      Setzt außer Kraft:
      copy in Klasse AbstractObject2ObjectMap<T,V>
      Gibt zurück:
      a Shallow Copy of the Map
    • forEach

      public void forEach(ObjectObjectConsumer<T,V> action)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      Type Specific forEach method to reduce boxing/unboxing
      Angegeben von:
      forEach in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      forEach in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      action - processor of the values that are iterator over
    • replace

      public boolean replace(T key, V oldValue, V newValue)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific replace method to replace an existing value
      Angegeben von:
      replace in Schnittstelle Map<T,V>
      Angegeben von:
      replace in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      replace in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the element that should be searched for
      oldValue - the expected value to be replaced
      newValue - the value to replace the oldValue with.
      Gibt zurück:
      true if the value got replaced
    • replace

      public V replace(T key, V value)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific replace method to reduce boxing/unboxing replace an existing value
      Angegeben von:
      replace in Schnittstelle Map<T,V>
      Angegeben von:
      replace in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      replace in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the element that should be searched for
      value - the value to replace with.
      Gibt zurück:
      the present value or default return value
    • compute

      public V compute(T key, ObjectObjectUnaryOperator<T,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific compute method to reduce boxing/unboxing If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      compute in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      compute in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the key that should be computed
      mappingFunction - the operator that should generate the value
      Gibt zurück:
      the result of the computation
    • computeIfAbsent

      public V computeIfAbsent(T key, UnaryOperator<T,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific computeIfAbsent method to reduce boxing/unboxing If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      computeIfAbsent in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      computeIfAbsent in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the key that should be computed
      mappingFunction - the operator that should generate the value if not present
      Gibt zurück:
      the result of the computed value or present value
    • supplyIfAbsent

      public V supplyIfAbsent(T key, ObjectSupplier<V> valueProvider)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Supplier based computeIfAbsent function to fill the most used usecase of this function If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      supplyIfAbsent in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      supplyIfAbsent in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the key that should be computed
      valueProvider - the value if not present
      Gibt zurück:
      the result of the computed value or present value
    • computeIfPresent

      public V computeIfPresent(T key, ObjectObjectUnaryOperator<T,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific compute method to reduce boxing/unboxing If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      computeIfPresent in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      computeIfPresent in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the key that should be computed
      mappingFunction - the operator that should generate the value if present
      Gibt zurück:
      the result of the default return value or present value
    • merge

      public V merge(T key, V value, ObjectObjectUnaryOperator<V,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Type Specific merge method to reduce boxing/unboxing If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      merge in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      merge in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      key - the key that should be be searched for
      value - the value that should be merged with
      mappingFunction - the operator that should generate the new Value
      Gibt zurück:
      the result of the merge
    • mergeAll

      public void mergeAll(Object2ObjectMap<T,V> m, ObjectObjectUnaryOperator<V,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Object2ObjectMap
      A Bulk method for merging Maps. If the generated value equals the getDefaultReturnValue it will simply not insert it since that is treated as "null". A "Null Value" will be treated as "Do not insert/remove" based on how the Java has specified it.
      Angegeben von:
      mergeAll in Schnittstelle Object2ObjectMap<T,V>
      Setzt außer Kraft:
      mergeAll in Klasse AbstractObject2ObjectMap<T,V>
      Parameter:
      m - the entries that should be bulk added
      mappingFunction - the operator that should generate the new Value
    • size

      public int size()
      Angegeben von:
      size in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      size in Klasse AbstractMap<T,V>
    • clear

      public void clear()
      Angegeben von:
      clear in Schnittstelle Map<T,V>
      Setzt außer Kraft:
      clear in Klasse AbstractMap<T,V>