com.helger.commons.collection.multimap

Class AbstractMultiConcurrentHashMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.concurrent.ConcurrentHashMap<KEYTYPE,COLLTYPE>

com.helger.commons.collection.multimap.AbstractMultiConcurrentHashMap<KEYTYPE,VALUETYPE,COLLTYPE>

Type Parameters:

KEYTYPE - key type

VALUETYPE - value type

COLLTYPE - contained collection type

All Implemented Interfaces:

IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE>, Serializable, ConcurrentMap<KEYTYPE,COLLTYPE>, Map<KEYTYPE,COLLTYPE>

Direct Known Subclasses:

AbstractMultiConcurrentHashMapListBased, AbstractMultiConcurrentHashMapSetBased

@NotThreadSafe
public abstract class AbstractMultiConcurrentHashMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>
extends ConcurrentHashMap<KEYTYPE,COLLTYPE>
implements IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE>

Abstract multi map based on ConcurrentHashMap.
Important note: null keys are not allowed here!

Author:

Philip Helger

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.concurrent.ConcurrentHashMap

ConcurrentHashMap.KeySetView<K,V>

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

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

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
AbstractMultiConcurrentHashMap()
AbstractMultiConcurrentHashMap(KEYTYPE aKey, COLLTYPE aCollection)
AbstractMultiConcurrentHashMap(KEYTYPE aKey, VALUETYPE aValue)
AbstractMultiConcurrentHashMap(Map<? extends KEYTYPE,? extends COLLTYPE> aCont)

Method Summary

Modifier and Type	Method and Description
boolean	containsSingle(KEYTYPE aKey, VALUETYPE aValue) Check a single element from the container identified by the passed key is present.
protected abstract COLLTYPE	createNewCollection()
COLLTYPE	getOrCreate(KEYTYPE aKey) Get or create the collection of the specified key.
long	getTotalValueCount()
EChange	putAllIn(Map<? extends KEYTYPE,? extends VALUETYPE> aMap) Add all values into the container identified by the passed key-value-map.
EChange	putSingle(KEYTYPE aKey, VALUETYPE aValue) Add a single value into the container identified by the passed key.
EChange	removeSingle(KEYTYPE aKey, VALUETYPE aValue) Remove a single element from the container identified by the passed key.

Methods inherited from class java.util.concurrent.ConcurrentHashMap

clear, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, forEach, forEach, forEachEntry, forEachEntry, forEachKey, forEachKey, forEachValue, forEachValue, get, getOrDefault, hashCode, isEmpty, keys, keySet, keySet, mappingCount, merge, newKeySet, newKeySet, put, putAll, putIfAbsent, reduce, reduceEntries, reduceEntries, reduceEntriesToDouble, reduceEntriesToInt, reduceEntriesToLong, reduceKeys, reduceKeys, reduceKeysToDouble, reduceKeysToInt, reduceKeysToLong, reduceToDouble, reduceToInt, reduceToLong, reduceValues, reduceValues, reduceValuesToDouble, reduceValuesToInt, reduceValuesToLong, remove, remove, replace, replace, replaceAll, search, searchEntries, searchKeys, searchValues, size, toString, values

Methods inherited from class java.util.AbstractMap

clone

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Constructor Detail

AbstractMultiConcurrentHashMap

public AbstractMultiConcurrentHashMap()

AbstractMultiConcurrentHashMap

public AbstractMultiConcurrentHashMap(@Nonnull
                                      KEYTYPE aKey,
                                      @Nullable
                                      VALUETYPE aValue)

AbstractMultiConcurrentHashMap

public AbstractMultiConcurrentHashMap(@Nonnull
                                      KEYTYPE aKey,
                                      @Nonnull
                                      COLLTYPE aCollection)

AbstractMultiConcurrentHashMap

public AbstractMultiConcurrentHashMap(@Nullable
                                      Map<? extends KEYTYPE,? extends COLLTYPE> aCont)

Method Detail

createNewCollection

@Nonnull
 @ReturnsMutableCopy
protected abstract COLLTYPE createNewCollection()

getOrCreate

@Nonnull
 @ReturnsMutableObject(value="design")
public COLLTYPE getOrCreate(@Nonnull
                                                                              KEYTYPE aKey)

Description copied from interface: IMultiMap

Get or create the collection of the specified key.

Specified by:

getOrCreate in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Parameters:

aKey - The key to use. May not be null.

Returns:

The mutable collection to be used. Never null.

putSingle

@Nonnull
public final EChange putSingle(@Nonnull
                                         KEYTYPE aKey,
                                         @Nullable
                                         VALUETYPE aValue)

Description copied from interface: IMultiMap

Add a single value into the container identified by the passed key.

Specified by:

putSingle in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Parameters:

aKey - The key to use. May not be null.

aValue - The value to be added. May be null.

Returns:

EChange

putAllIn

@Nonnull
public final EChange putAllIn(@Nonnull
                                        Map<? extends KEYTYPE,? extends VALUETYPE> aMap)

Description copied from interface: IMultiMap

Add all values into the container identified by the passed key-value-map.

Specified by:

putAllIn in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Parameters:

aMap - The key-value-map to use. May not be null.

Returns:

EChange

removeSingle

@Nonnull
public final EChange removeSingle(@Nonnull
                                            KEYTYPE aKey,
                                            @Nullable
                                            VALUETYPE aValue)

Description copied from interface: IMultiMap

Remove a single element from the container identified by the passed key.

Specified by:

removeSingle in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Parameters:

aKey - The key to use. May not be null.

aValue - The value to be removed. May be null.

Returns:

EChange

containsSingle

public final boolean containsSingle(@Nonnull
                                    KEYTYPE aKey,
                                    @Nullable
                                    VALUETYPE aValue)

Description copied from interface: IMultiMap

Check a single element from the container identified by the passed key is present.

Specified by:

containsSingle in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Parameters:

aKey - The key to use. May not be null.

aValue - The value to be checked. May be null.

Returns:

true if the value is contained, false otherwise

getTotalValueCount

@Nonnegative
public final long getTotalValueCount()

Specified by:

getTotalValueCount in interface IMultiMap<KEYTYPE,VALUETYPE,COLLTYPE extends Collection<VALUETYPE>>

Returns:

The total number of contained values recursively over all contained maps. Always ≥ 0.