Modul speiger.src.collections
Package speiger.src.collections.bytes.maps.impl.concurrent

Klasse Byte2ObjectConcurrentOpenHashMap<V>

java.lang.Object
java.util.AbstractMap<Byte,V>
speiger.src.collections.bytes.maps.abstracts.AbstractByte2ObjectMap<V>
speiger.src.collections.bytes.maps.impl.concurrent.Byte2ObjectConcurrentOpenHashMap<V>
Typparameter:
V - the keyType of elements maintained by this Collection
Alle implementierten Schnittstellen:
ConcurrentMap<Byte,V>, Map<Byte,V>, ByteFunction<V>, Byte2ObjectConcurrentMap<V>, Byte2ObjectMap<V>, ITrimmable
public class Byte2ObjectConcurrentOpenHashMap<V> extends AbstractByte2ObjectMap<V> implements Byte2ObjectConcurrentMap<V>, ITrimmable
A TypeSpecific ConcurrentHashMap implementation that is based on Guavas approach and backing array implementations. Like Guavas implementation this solution can be accessed by multiple threads, but it is not as flexible as Javas implementation. The concurrencyLevel decides how many pools exist, and each pool can be accessed by 1 thread for writing and as many threads for reading. Though it is ill adviced to iterate over the collection using the Iterator if the Map is written to. Keep that in mind.

  • Konstruktordetails

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap()
      Default Constructor

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(int minCapacity)
      Constructor that defines the minimum capacity
      Parameter:
      minCapacity - the minimum capacity the HashMap is allowed to be.
      Löst aus:
      IllegalStateException - if the minimum capacity is negative

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(int minCapacity, float loadFactor)
      Constructor that defines the minimum capacity and load factor
      Parameter:
      minCapacity - the minimum capacity the HashMap is allowed to be.
      loadFactor - the percentage of how full the backing array can be before they resize
      Löst aus:
      IllegalStateException - if the minimum capacity is negative
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(int minCapacity, int concurrencyLevel)
      Constructor that defines the minimum capacity and concurrencyLevel
      Parameter:
      minCapacity - the minimum capacity the HashMap is allowed to be.
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the minimum capacity is negative
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(float loadFactor, int concurrencyLevel)
      Constructor that defines the load factor and concurrencyLevel
      Parameter:
      loadFactor - the percentage of how full the backing array can be before they resize
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(int minCapacity, float loadFactor, int concurrencyLevel)
      Constructor that defines the minimum capacity, load factor and concurrencyLevel
      Parameter:
      minCapacity - the minimum capacity the HashMap is allowed to be.
      loadFactor - the percentage of how full the backing array can be before they resize
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the minimum capacity is negative
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte[] keys, V[] values)
      Helper constructor that allow to create a map from boxed values (it will unbox them)
      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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte[] keys, V[] values, float loadFactor)
      Helper constructor that allow to create a map from boxed values (it will unbox them)
      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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte[] keys, V[] values, int concurrencyLevel)
      Helper constructor that allow to create a map from boxed values (it will unbox them)
      Parameter:
      keys - the keys that should be put into the map
      values - the values that should be put into the map.
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the keys and values do not match in lenght
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte[] keys, V[] values, float loadFactor, int concurrencyLevel)
      Helper constructor that allow to create a map from boxed values (it will unbox them)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      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
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(byte[] 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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(byte[] 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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(byte[] keys, V[] values, int concurrencyLevel)
      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.
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the keys and values do not match in lenght
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(byte[] keys, V[] values, float loadFactor, int concurrencyLevel)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      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
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Map<? extends Byte,? 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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Map<? extends Byte,? 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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Map<? extends Byte,? extends V> map, int concurrencyLevel)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Map<? extends Byte,? extends V> map, float loadFactor, int concurrencyLevel)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte2ObjectMap<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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte2ObjectMap<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

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte2ObjectMap<V> map, int concurrencyLevel)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

    • Byte2ObjectConcurrentOpenHashMap

      public Byte2ObjectConcurrentOpenHashMap(Byte2ObjectMap<V> map, float loadFactor, int concurrencyLevel)
      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
      concurrencyLevel - decides how many operations can be performed at once.
      Löst aus:
      IllegalStateException - if the loadfactor is either below/equal to 0 or above/equal to 1
      IllegalStateException - if the concurrencyLevel is either below/equal to 0 or above/equal to 65535

  • Methodendetails

    • put

      public V put(byte key, V value)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type Specific method to reduce boxing/unboxing of values
      Angegeben von:
      put in Schnittstelle Byte2ObjectMap<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(byte key, V value)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type Specific method to reduce boxing/unboxing of values
      Angegeben von:
      putIfAbsent in Schnittstelle Byte2ObjectMap<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:

    • remove

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

    • remove

      public boolean remove(byte key, V value)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type Specific remove function to reduce boxing/unboxing
      Angegeben von:
      remove in Schnittstelle Byte2ObjectMap<V>
      Parameter:
      key - the element that should be removed
      value - the expected value that should be found
      Gibt zurück:
      true if the key and value was found and removed
      Siehe auch:

    • remove

      public boolean remove(Object key, Object value)
      Angegeben von:
      remove in Schnittstelle Byte2ObjectConcurrentMap<V>
      Angegeben von:
      remove in Schnittstelle Byte2ObjectMap<V>
      Angegeben von:
      remove in Schnittstelle ConcurrentMap<Byte,V>
      Angegeben von:
      remove in Schnittstelle Map<Byte,V>
      Parameter:
      key - the element that should be removed
      value - the expected value that should be found
      Gibt zurück:
      true if the key and value was found and removed
      Siehe auch:

    • removeOrDefault

      public V removeOrDefault(byte key, V defaultValue)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type-Specific Remove function with a default return value if wanted.
      Angegeben von:
      removeOrDefault in Schnittstelle Byte2ObjectMap<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:

    • get

      public V get(byte key)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      A Type Specific get method to reduce boxing/unboxing
      Angegeben von:
      get in Schnittstelle Byte2ObjectMap<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 Byte2ObjectMap<V>
      Angegeben von:
      get in Schnittstelle Map<Byte,V>
      Setzt außer Kraft:
      get in Klasse AbstractByte2ObjectMap<V>

    • getOrDefault

      public V getOrDefault(byte key, V defaultValue)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      A Type Specific getOrDefault method to reduce boxing/unboxing
      Angegeben von:
      getOrDefault in Schnittstelle Byte2ObjectMap<V>
      Setzt außer Kraft:
      getOrDefault in Klasse AbstractByte2ObjectMap<V>
      Parameter:
      key - the key that is searched for
      defaultValue - the value that should be returned if the key is not present
      Gibt zurück:
      the searched value or defaultValue value

    • forEach

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

    • copy

      public Byte2ObjectConcurrentOpenHashMap<V> copy()
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      copy in Klasse AbstractByte2ObjectMap<V>
      Gibt zurück:
      a Shallow Copy of the Map

    • containsKey

      public boolean containsKey(byte key)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type Specific method to reduce boxing/unboxing of values
      Angegeben von:
      containsKey in Schnittstelle Byte2ObjectMap<V>
      Setzt außer Kraft:
      containsKey in Klasse AbstractByte2ObjectMap<V>
      Parameter:
      key - element that is searched for
      Gibt zurück:
      if the key is present

    • replace

      public boolean replace(byte key, V oldValue, V newValue)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      A Type Specific replace method to replace an existing value
      Angegeben von:
      replace in Schnittstelle Byte2ObjectMap<V>
      Setzt außer Kraft:
      replace in Klasse AbstractByte2ObjectMap<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(byte key, V value)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      A Type Specific replace method to reduce boxing/unboxing replace an existing value
      Angegeben von:
      replace in Schnittstelle Byte2ObjectMap<V>
      Setzt außer Kraft:
      replace in Klasse AbstractByte2ObjectMap<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(byte key, ByteObjectUnaryOperator<V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      compute in Klasse AbstractByte2ObjectMap<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(byte key, ByteFunction<V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      computeIfAbsent in Klasse AbstractByte2ObjectMap<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(byte key, ObjectSupplier<V> valueProvider)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      supplyIfAbsent in Klasse AbstractByte2ObjectMap<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(byte key, ByteObjectUnaryOperator<V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      computeIfPresent in Klasse AbstractByte2ObjectMap<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(byte key, V value, ObjectObjectUnaryOperator<V,V> mappingFunction)
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      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 Byte2ObjectMap<V>
      Setzt außer Kraft:
      merge in Klasse AbstractByte2ObjectMap<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

    • clear

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

    • trim

      public boolean trim(int size)
      Beschreibung aus Schnittstelle kopiert: ITrimmable
      Trims the original collection down to the size of the current elements or the requested size depending which is bigger
      Angegeben von:
      trim in Schnittstelle ITrimmable
      Parameter:
      size - the requested trim size.
      Gibt zurück:
      if the internal array has been trimmed.

    • clearAndTrim

      public void clearAndTrim(int size)
      Beschreibung aus Schnittstelle kopiert: ITrimmable
      Trims the collection down to the requested size and clears all elements while doing so
      Angegeben von:
      clearAndTrim in Schnittstelle ITrimmable
      Parameter:
      size - the amount of elements that should be allowed

    • isEmpty

      public boolean isEmpty()
      Angegeben von:
      isEmpty in Schnittstelle Map<Byte,V>
      Setzt außer Kraft:
      isEmpty in Klasse AbstractMap<Byte,V>

    • size

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

    • byte2ObjectEntrySet

      public ObjectSet<Byte2ObjectMap.Entry<V>> byte2ObjectEntrySet()
      Beschreibung aus Schnittstelle kopiert: Byte2ObjectMap
      Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
      Angegeben von:
      byte2ObjectEntrySet in Schnittstelle Byte2ObjectMap<V>
      Gibt zurück:
      a EntrySet of the collection

    • keySet

      public ByteSet keySet()
      Angegeben von:
      keySet in Schnittstelle Byte2ObjectMap<V>
      Angegeben von:
      keySet in Schnittstelle Map<Byte,V>
      Setzt außer Kraft:
      keySet in Klasse AbstractByte2ObjectMap<V>

    • values

      public ObjectCollection<V> values()
      Angegeben von:
      values in Schnittstelle Byte2ObjectMap<V>
      Angegeben von:
      values in Schnittstelle Map<Byte,V>
      Setzt außer Kraft:
      values in Klasse AbstractByte2ObjectMap<V>