Package it.tidalwave.util

Class ConcurrentHashMapWithOptionals<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.concurrent.ConcurrentHashMap<K,V>

it.tidalwave.util.ConcurrentHashMapWithOptionals<K,V>

Type Parameters:

K - the type of the key

V - the type of the value

All Implemented Interfaces:

Serializable, ConcurrentMap<K,V>, Map<K,V>

public class ConcurrentHashMapWithOptionals<K,V>
extends ConcurrentHashMap<K,V>

A specialisation of ConcurrentHashMap with Optional support.

Since:

3.1-ALPHA-2

Author:

Fabrizio Giudici

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	Description
ConcurrentHashMapWithOptionals()

Method Summary

Modifier and Type	Method	Description
Optional<K>	putIfAbsentAndGetNewKey(Optional<? extends K> optionalKey, V value)	If the map doesn't contain the given key, put the new pair(key, value), and return the key itself.
Optional<K>	putIfAbsentAndGetNewKey(K key, V value)	If the map doesn't contain the given key, put the new pair(key, value), and return the key itself.

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

Constructor Details

ConcurrentHashMapWithOptionals

public ConcurrentHashMapWithOptionals()

Method Details

putIfAbsentAndGetNewKey

@Nonnull
public Optional<K> putIfAbsentAndGetNewKey(@Nonnull
 Optional<? extends K> optionalKey,
 @Nonnull
 V value)

If the map doesn't contain the given key, put the new pair(key, value), and return the key itself. Otherwise, do nothing and return an empty Optional. The map manipulation is atomically performed by calling ConcurrentHashMap.putIfAbsent(java.lang.Object, java.lang.Object). If optionalKey is empty, do nothing and return nothing.

Parameters:

optionalKey - the key

value - the value

Returns:

the new key, or nothing

putIfAbsentAndGetNewKey

@Nonnull
public Optional<K> putIfAbsentAndGetNewKey(@Nonnull
 K key,
 @Nonnull
 V value)

If the map doesn't contain the given key, put the new pair(key, value), and return the key itself. Otherwise, do nothing and return an empty Optional. The map manipulation is atomically performed by calling ConcurrentHashMap.putIfAbsent(java.lang.Object, java.lang.Object).

Parameters:

key - the key

value - the value

Returns:

the new key, or nothing