com.stoyanr.evictor.map

Class ConcurrentHashMapWithTimedEviction<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

com.stoyanr.evictor.map.ConcurrentMapWithTimedEvictionDecorator<K,V>

com.stoyanr.evictor.map.ConcurrentHashMapWithTimedEviction<K,V>

Type Parameters:

K - the type of keys maintained by this map

V - the type of mapped values

All Implemented Interfaces:

ConcurrentMapWithTimedEviction<K,V>, ConcurrentMap<K,V>, Map<K,V>

public class ConcurrentHashMapWithTimedEviction<K,V>
extends ConcurrentMapWithTimedEvictionDecorator<K,V>
implements ConcurrentMapWithTimedEviction<K,V>

A ConcurrentMapWithTimedEviction which conforms to the ConcurrentHashMap specification. This class is a simple extension of ConcurrentMapWithTimedEvictionDecorator which always uses an instance of ConcurrentHashMap as a delegate. For convenience, it provides a number of overloaded constructors which correspond to the constructors provided by the ConcurrentHashMap class.

Like ConcurrentHashMap, this class does not allow null to be used as a key or value.

Author:

Stoyan Rachev

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
ConcurrentHashMapWithTimedEviction() Creates a new, empty map that supports timed entry eviction with a default initial capacity (16), load factor (0.75), concurrencyLevel (16), and eviction scheduler.
ConcurrentHashMapWithTimedEviction(EvictionScheduler<K,V> scheduler) Creates a new, empty map that supports timed entry eviction with the specified eviction scheduler, and with the default, initial capacity (16), load factor (0.75) and concurrencyLevel (16).
ConcurrentHashMapWithTimedEviction(int initialCapacity) Creates a new, empty map that supports timed entry eviction with the specified initial capacity, and with the default load factor (0.75), concurrencyLevel (16), and eviction scheduler.
ConcurrentHashMapWithTimedEviction(int initialCapacity, EvictionScheduler<K,V> scheduler) Creates a new, empty map that supports timed entry eviction with the specified initial capacity and eviction scheduler, and with the default load factor (0.75) and concurrencyLevel (16).
ConcurrentHashMapWithTimedEviction(int initialCapacity, float loadFactor) Creates a new, empty map that supports timed entry eviction with the specified initial capacity and load factor, and with the default concurrencyLevel (16) and eviction scheduler.
ConcurrentHashMapWithTimedEviction(int initialCapacity, float loadFactor, EvictionScheduler<K,V> scheduler) Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor and eviction scheduler, and with the default concurrencyLevel (16).
ConcurrentHashMapWithTimedEviction(int initialCapacity, float loadFactor, int concurrencyLevel) Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor, and concurrency level, and with the default eviction scheduler.
ConcurrentHashMapWithTimedEviction(int initialCapacity, float loadFactor, int concurrencyLevel, EvictionScheduler<K,V> scheduler) Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor, concurrency level, and eviction scheduler.

Method Summary

Methods inherited from class com.stoyanr.evictor.map.ConcurrentMapWithTimedEvictionDecorator

clear, containsKey, containsValue, entrySet, get, keySet, put, put, putIfAbsent, putIfAbsent, remove, remove, replace, replace, replace, replace, size

Methods inherited from class java.util.AbstractMap

clone, equals, hashCode, isEmpty, putAll, toString, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.stoyanr.evictor.ConcurrentMapWithTimedEviction

put, putIfAbsent, replace, replace

Methods inherited from interface java.util.concurrent.ConcurrentMap

putIfAbsent, remove, replace, replace

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Constructor Detail

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity,
                                  float loadFactor,
                                  int concurrencyLevel,
                                  EvictionScheduler<K,V> scheduler)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor, concurrency level, and eviction scheduler.

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

loadFactor - the load factor threshold, used to control resizing. Resizing may be performed when the average number of elements per bin exceeds this threshold.

concurrencyLevel - the estimated number of concurrently updating threads. The implementation performs internal sizing to try to accommodate this many threads.

scheduler - the scheduler used for automatically evicting entries when the time they are allowed to stay in the map has elapsed.

Throws:

IllegalArgumentException - if the initial capacity is negative or the load factor or concurrencyLevel are non-positive.

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity,
                                  float loadFactor,
                                  int concurrencyLevel)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor, and concurrency level, and with the default eviction scheduler.

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

loadFactor - the load factor threshold, used to control resizing. Resizing may be performed when the average number of elements per bin exceeds this threshold.

concurrencyLevel - the estimated number of concurrently updating threads. The implementation performs internal sizing to try to accommodate this many threads.

Throws:

IllegalArgumentException - if the initial capacity is negative or the load factor or concurrencyLevel are non-positive.

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity,
                                  float loadFactor,
                                  EvictionScheduler<K,V> scheduler)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity, load factor and eviction scheduler, and with the default concurrencyLevel (16).

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

loadFactor - the load factor threshold, used to control resizing. Resizing may be performed when the average number of elements per bin exceeds this threshold.

scheduler - the scheduler used for automatically evicting entries when the time they are allowed to stay in the map has elapsed.

Throws:

IllegalArgumentException - if the initial capacity of elements is negative or the load factor is non-positive

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity,
                                  float loadFactor)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity and load factor, and with the default concurrencyLevel (16) and eviction scheduler.

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

loadFactor - the load factor threshold, used to control resizing. Resizing may be performed when the average number of elements per bin exceeds this threshold.

Throws:

IllegalArgumentException - if the initial capacity of elements is negative or the load factor is non-positive

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity,
                                  EvictionScheduler<K,V> scheduler)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity and eviction scheduler, and with the default load factor (0.75) and concurrencyLevel (16).

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

scheduler - the scheduler used for automatically evicting entries when the time they are allowed to stay in the map has elapsed.

Throws:

IllegalArgumentException - if the initial capacity of elements is negative

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(int initialCapacity)

Creates a new, empty map that supports timed entry eviction with the specified initial capacity, and with the default load factor (0.75), concurrencyLevel (16), and eviction scheduler.

Parameters:

initialCapacity - the initial capacity. The implementation performs internal sizing to accommodate this many elements.

Throws:

IllegalArgumentException - if the initial capacity of elements is negative

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction(EvictionScheduler<K,V> scheduler)

Creates a new, empty map that supports timed entry eviction with the specified eviction scheduler, and with the default, initial capacity (16), load factor (0.75) and concurrencyLevel (16).

Parameters:

scheduler - the scheduler used for automatically evicting entries when the time they are allowed to stay in the map has elapsed.

ConcurrentHashMapWithTimedEviction

public ConcurrentHashMapWithTimedEviction()

Creates a new, empty map that supports timed entry eviction with a default initial capacity (16), load factor (0.75), concurrencyLevel (16), and eviction scheduler.