com.cinchapi.concourse.util

Class ConcurrentMaps

Object

ConcurrentMaps

public final class ConcurrentMaps
extends Object

Utility class for the ConcurrentMap interface.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	SPIN_THRESHOLD_IN_MILLIS The amount of time to spin before backing off and waiting.

Constructor Summary

Constructors

Constructor and Description
ConcurrentMaps()

Method Summary

Modifier and Type	Method and Description
static <K,V> V	putAndSignal(ConcurrentMap<K,V> map, K key, V value) Place the key in the map and associated it with the value.
static <K,V> V	waitAndRemove(ConcurrentMap<K,V> map, K key) Execute the Map.remove(Object) method while causing the current thread to block, if necessary, until the key is in the map and associated with a non-null value.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SPIN_THRESHOLD_IN_MILLIS

protected static int SPIN_THRESHOLD_IN_MILLIS

The amount of time to spin before backing off and waiting.

Constructor Detail

ConcurrentMaps

public ConcurrentMaps()

Method Detail

putAndSignal

public static <K,V> V putAndSignal(ConcurrentMap<K,V> map,
                                   K key,
                                   V value)

Place the key in the map and associated it with the value. Finally, send a signal to threads waiting on a signal to remove the key.

Parameters:

map - the map into which the key and value are placed

key - the key to associate with the value

value - the value to associate with the key

Returns:

the value that was previously associated with key in the map

waitAndRemove

public static <K,V> V waitAndRemove(ConcurrentMap<K,V> map,
                                    K key)

Execute the Map.remove(Object) method while causing the current thread to block, if necessary, until the key is in the map and associated with a non-null value.

This method should only be used in conjunction with the putAndSignal(ConcurrentMap, Object, Object) method.

Parameters:

map - the map from which the key is removed

key - the key to remove from the map

Returns:

the non-null value that was associated with a key and is therefore removed.