speiger.src.collections.longs.maps.abstracts

Class AbstractLong2ObjectMap<V>

java.lang.Object

java.util.AbstractMap<java.lang.Long,V>

speiger.src.collections.longs.maps.abstracts.AbstractLong2ObjectMap<V>

Type Parameters:

V - the keyType of elements maintained by this Collection

All Implemented Interfaces:

java.util.function.LongFunction<V>, java.util.Map<java.lang.Long,V>, Long2ObjectMap<V>

Direct Known Subclasses:

ImmutableLong2ObjectOpenHashMap, Long2ObjectArrayMap, Long2ObjectAVLTreeMap, Long2ObjectConcurrentOpenHashMap, Long2ObjectMaps.EmptyMap, Long2ObjectMaps.SingletonMap, Long2ObjectMaps.SynchronizedMap, Long2ObjectMaps.UnmodifyableMap, Long2ObjectOpenCustomHashMap, Long2ObjectOpenHashMap, Long2ObjectRBTreeMap

public abstract class AbstractLong2ObjectMap<V>
extends java.util.AbstractMap<java.lang.Long,V>
implements Long2ObjectMap<V>

A Base Implementation of a Type Specific Map to reduce boxing/unboxing

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractLong2ObjectMap.BasicEntry<V> A Simple Type Specific Entry class to reduce boxing/unboxing

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface speiger.src.collections.longs.maps.interfaces.Long2ObjectMap

Long2ObjectMap.BuilderCache<V>, Long2ObjectMap.Entry<V>, Long2ObjectMap.FastEntrySet<V>, Long2ObjectMap.MapBuilder

Constructor Summary

Constructors

Constructor and Description
AbstractLong2ObjectMap()

Method Summary

Modifier and Type	Method and Description
V	compute(long key, LongObjectUnaryOperator<V> mappingFunction) A Type Specific compute method to reduce boxing/unboxing
V	computeIfAbsent(long key, LongFunction<V> mappingFunction) A Type Specific compute method to reduce boxing/unboxing
V	computeIfPresent(long key, LongObjectUnaryOperator<V> mappingFunction) A Type Specific compute method to reduce boxing/unboxing
boolean	containsKey(long key) Type Specific method to reduce boxing/unboxing of values
boolean	containsValue(java.lang.Object value)
Long2ObjectMap<V>	copy() A Function that does a shallow clone of the Map itself.
ObjectSet<java.util.Map.Entry<java.lang.Long,V>>	entrySet()
boolean	equals(java.lang.Object o)
void	forEach(LongObjectConsumer<V> action) Type Specific forEach method to reduce boxing/unboxing
V	get(java.lang.Object key)
V	getDefaultReturnValue() Method to see what the default return value is.
V	getOrDefault(long key, V defaultValue) A Type Specific getOrDefault method to reduce boxing/unboxing
V	getOrDefault(java.lang.Object key, V defaultValue)
int	hashCode()
LongSet	keySet()
V	merge(long key, V value, ObjectObjectUnaryOperator<V,V> mappingFunction) A Type Specific merge method to reduce boxing/unboxing
void	mergeAll(Long2ObjectMap<V> m, ObjectObjectUnaryOperator<V,V> mappingFunction) A Bulk method for merging Maps.
V	put(java.lang.Long key, V value) Deprecated.
void	putAll(long[] keys, V[] values, int offset, int size) Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances
void	putAll(java.lang.Long[] keys, V[] values, int offset, int size) Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances
void	putAll(Long2ObjectMap<V> m) Type Specific function for the bull putting of values
void	putAll(java.util.Map<? extends java.lang.Long,? extends V> m)
void	putAllIfAbsent(Long2ObjectMap<V> m) Type-Specific bulk put method put elements into the map if not present.
V	remove(java.lang.Object key)
V	replace(long key, V value) A Type Specific replace method to reduce boxing/unboxing replace an existing value
boolean	replace(long key, V oldValue, V newValue) A Type Specific replace method to replace an existing value
void	replaceObjects(Long2ObjectMap<V> m) Type-Specific bulk replace method.
void	replaceObjects(LongObjectUnaryOperator<V> mappingFunction) A Type Specific mass replace method to reduce boxing/unboxing
AbstractLong2ObjectMap<V>	setDefaultReturnValue(V v) Method to define the default return value if a requested key isn't present
V	supplyIfAbsent(long key, ObjectSupplier<V> valueProvider) A Supplier based computeIfAbsent function to fill the most used usecase of this function
ObjectCollection<V>	values()

Methods inherited from class java.util.AbstractMap

clear, containsKey, isEmpty, size, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface speiger.src.collections.longs.maps.interfaces.Long2ObjectMap

apply, builder, compute, computeIfAbsent, computeIfPresent, containsKey, forEach, get, long2ObjectEntrySet, merge, put, put, put, putAll, putAll, putIfAbsent, putIfAbsent, remove, remove, remove, removeOrDefault, replace, replace, replaceAll, synchronize, synchronize, unmodifiable

Methods inherited from interface java.util.Map

clear, isEmpty, size

Constructor Detail

AbstractLong2ObjectMap

public AbstractLong2ObjectMap()

Method Detail

getDefaultReturnValue

public V getDefaultReturnValue()

Description copied from interface: Long2ObjectMap

Method to see what the default return value is.

Specified by:

getDefaultReturnValue in interface Long2ObjectMap<V>

Returns:

default return value

setDefaultReturnValue

public AbstractLong2ObjectMap<V> setDefaultReturnValue(V v)

Description copied from interface: Long2ObjectMap

Method to define the default return value if a requested key isn't present

Specified by:

setDefaultReturnValue in interface Long2ObjectMap<V>

Parameters:

v - value that should be the default return value

Returns:

itself

copy

public Long2ObjectMap<V> copy()

Description copied from interface: Long2ObjectMap

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

Specified by:

copy in interface Long2ObjectMap<V>

Returns:

a Shallow Copy of the Map

put

@Deprecated
public V put(java.lang.Long key,
                          V value)

Deprecated.

Specified by:

put in interface java.util.Map<java.lang.Long,V>

Specified by:

put in interface Long2ObjectMap<V>

Overrides:

put in class java.util.AbstractMap<java.lang.Long,V>

putAll

public void putAll(Long2ObjectMap<V> m)

Description copied from interface: Long2ObjectMap

Type Specific function for the bull putting of values

Specified by:

putAll in interface Long2ObjectMap<V>

Parameters:

m - the elements that should be inserted

putAll

public void putAll(java.util.Map<? extends java.lang.Long,? extends V> m)

Specified by:

putAll in interface java.util.Map<java.lang.Long,V>

Overrides:

putAll in class java.util.AbstractMap<java.lang.Long,V>

putAll

public void putAll(long[] keys,
                   V[] values,
                   int offset,
                   int size)

Description copied from interface: Long2ObjectMap

Type Specific array method to bulk add elements into a map without creating a wrapper and increasing performances

Specified by:

putAll in interface Long2ObjectMap<V>

Parameters:

keys - the keys that should be added

values - the values that should be added

offset - where the to start in the array

size - how many elements should be added

See Also:

Map.putAll(Map)

putAll

public void putAll(java.lang.Long[] keys,
                   V[] values,
                   int offset,
                   int size)

Description copied from interface: Long2ObjectMap

Type Specific Object array method to bulk add elements into a map without creating a wrapper and increasing performances

Specified by:

putAll in interface Long2ObjectMap<V>

Parameters:

keys - the keys that should be added

values - the values that should be added

offset - where the to start in the array

size - how many elements should be added

See Also:

Map.putAll(Map)

putAllIfAbsent

public void putAllIfAbsent(Long2ObjectMap<V> m)

Description copied from interface: Long2ObjectMap

Type-Specific bulk put method put elements into the map if not present.

Specified by:

putAllIfAbsent in interface Long2ObjectMap<V>

Parameters:

m - elements that should be added if not present.

containsKey

public boolean containsKey(long key)

Description copied from interface: Long2ObjectMap

Type Specific method to reduce boxing/unboxing of values

Specified by:

containsKey in interface Long2ObjectMap<V>

Parameters:

key - element that is searched for

Returns:

if the key is present

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<java.lang.Long,V>

Overrides:

containsValue in class java.util.AbstractMap<java.lang.Long,V>

replace

public boolean replace(long key,
                       V oldValue,
                       V newValue)

Description copied from interface: Long2ObjectMap

A Type Specific replace method to replace an existing value

Specified by:

replace in interface Long2ObjectMap<V>

Parameters:

key - the element that should be searched for

oldValue - the expected value to be replaced

newValue - the value to replace the oldValue with.

Returns:

true if the value got replaced

replace

public V replace(long key,
                 V value)

Description copied from interface: Long2ObjectMap

A Type Specific replace method to reduce boxing/unboxing replace an existing value

Specified by:

replace in interface Long2ObjectMap<V>

Parameters:

key - the element that should be searched for

value - the value to replace with.

Returns:

the present value or default return value

replaceObjects

public void replaceObjects(Long2ObjectMap<V> m)

Description copied from interface: Long2ObjectMap

Type-Specific bulk replace method. Could be seen as putAllIfPresent

Specified by:

replaceObjects in interface Long2ObjectMap<V>

Parameters:

m - elements that should be replaced.

replaceObjects

public void replaceObjects(LongObjectUnaryOperator<V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Type Specific mass replace method to reduce boxing/unboxing

Specified by:

replaceObjects in interface Long2ObjectMap<V>

Parameters:

mappingFunction - operation to replace all values

compute

public V compute(long key,
                 LongObjectUnaryOperator<V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Type Specific compute method to reduce boxing/unboxing

Specified by:

compute in interface Long2ObjectMap<V>

Parameters:

key - the key that should be computed

mappingFunction - the operator that should generate the value

Returns:

the result of the computation

computeIfAbsent

public V computeIfAbsent(long key,
                         LongFunction<V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Type Specific compute method to reduce boxing/unboxing

Specified by:

computeIfAbsent in interface Long2ObjectMap<V>

Parameters:

key - the key that should be computed

mappingFunction - the operator that should generate the value if not present

Returns:

the result of the computed value or present value

supplyIfAbsent

public V supplyIfAbsent(long key,
                        ObjectSupplier<V> valueProvider)

Description copied from interface: Long2ObjectMap

A Supplier based computeIfAbsent function to fill the most used usecase of this function

Specified by:

supplyIfAbsent in interface Long2ObjectMap<V>

Parameters:

key - the key that should be computed

valueProvider - the value if not present

Returns:

the result of the computed value or present value

computeIfPresent

public V computeIfPresent(long key,
                          LongObjectUnaryOperator<V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Type Specific compute method to reduce boxing/unboxing

Specified by:

computeIfPresent in interface Long2ObjectMap<V>

Parameters:

key - the key that should be computed

mappingFunction - the operator that should generate the value if present

Returns:

the result of the default return value or present value

merge

public V merge(long key,
               V value,
               ObjectObjectUnaryOperator<V,V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Type Specific merge method to reduce boxing/unboxing

Specified by:

merge in interface Long2ObjectMap<V>

Parameters:

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

Returns:

the result of the merge

mergeAll

public void mergeAll(Long2ObjectMap<V> m,
                     ObjectObjectUnaryOperator<V,V> mappingFunction)

Description copied from interface: Long2ObjectMap

A Bulk method for merging Maps.

Specified by:

mergeAll in interface Long2ObjectMap<V>

Parameters:

m - the entries that should be bulk added

mappingFunction - the operator that should generate the new Value

get

public V get(java.lang.Object key)

Specified by:

get in interface java.util.Map<java.lang.Long,V>

Specified by:

get in interface Long2ObjectMap<V>

Overrides:

get in class java.util.AbstractMap<java.lang.Long,V>

getOrDefault

public V getOrDefault(java.lang.Object key,
                      V defaultValue)

Specified by:

getOrDefault in interface java.util.Map<java.lang.Long,V>

Specified by:

getOrDefault in interface Long2ObjectMap<V>

getOrDefault

public V getOrDefault(long key,
                      V defaultValue)

Description copied from interface: Long2ObjectMap

A Type Specific getOrDefault method to reduce boxing/unboxing

Specified by:

getOrDefault in interface Long2ObjectMap<V>

Parameters:

key - the key that is searched for

defaultValue - the value that should be returned if the key is not present

Returns:

the searched value or defaultValue value

remove

public V remove(java.lang.Object key)

Specified by:

remove in interface java.util.Map<java.lang.Long,V>

Specified by:

remove in interface Long2ObjectMap<V>

Overrides:

remove in class java.util.AbstractMap<java.lang.Long,V>

Parameters:

key - the element that should be removed

Returns:

the value that was removed or default return value

See Also:

Map.remove(Object)

forEach

public void forEach(LongObjectConsumer<V> action)

Description copied from interface: Long2ObjectMap

Type Specific forEach method to reduce boxing/unboxing

Specified by:

forEach in interface Long2ObjectMap<V>

Parameters:

action - processor of the values that are iterator over

keySet

public LongSet keySet()

Specified by:

keySet in interface java.util.Map<java.lang.Long,V>

Specified by:

keySet in interface Long2ObjectMap<V>

Overrides:

keySet in class java.util.AbstractMap<java.lang.Long,V>

values

public ObjectCollection<V> values()

Specified by:

values in interface java.util.Map<java.lang.Long,V>

Specified by:

values in interface Long2ObjectMap<V>

Overrides:

values in class java.util.AbstractMap<java.lang.Long,V>

entrySet

public ObjectSet<java.util.Map.Entry<java.lang.Long,V>> entrySet()

Specified by:

entrySet in interface java.util.Map<java.lang.Long,V>

Specified by:

entrySet in interface Long2ObjectMap<V>

Specified by:

entrySet in class java.util.AbstractMap<java.lang.Long,V>

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.util.Map<java.lang.Long,V>

Overrides:

equals in class java.util.AbstractMap<java.lang.Long,V>

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Map<java.lang.Long,V>

Overrides:

hashCode in class java.util.AbstractMap<java.lang.Long,V>