com.phloc.commons.collections.multimap

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

java.lang.Object

java.util.AbstractMap<K,V>

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

com.phloc.commons.collections.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.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

Methods

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, contains, containsKey, containsValue, elements, entrySet, get, isEmpty, keys, keySet, put, putAll, putIfAbsent, remove, remove, replace, replace, size, values

Methods inherited from class java.util.AbstractMap

clone, equals, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, 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
protected abstract COLLTYPE createNewCollection()

getOrCreate

@Nonnull
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:

EChange

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:

EChange

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. Always ≥ 0.