cn.jants.restful.bind

类 ConcurrentReferenceHashMap<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

cn.jants.restful.bind.ConcurrentReferenceHashMap<K,V>

类型参数:

K - The key type

V - The value type

所有已实现的接口:

java.util.concurrent.ConcurrentMap<K,V>, java.util.Map<K,V>

public class ConcurrentReferenceHashMap<K,V>
extends java.util.AbstractMap<K,V>
implements java.util.concurrent.ConcurrentMap<K,V>

soft entry references.

从以下版本开始:

3.2

作者:

Phillip Webb

嵌套类概要

嵌套类

限定符和类型	类和说明
protected static class	ConcurrentReferenceHashMap.Entry<K,V> A single map entry.
protected static interface	ConcurrentReferenceHashMap.Reference<K,V> A reference to an ConcurrentReferenceHashMap.Entry contained in the map.
protected class	ConcurrentReferenceHashMap.ReferenceManager Strategy class used to manage ConcurrentReferenceHashMap.References.
static class	ConcurrentReferenceHashMap.ReferenceType Various reference types supported by this map.
protected static class	ConcurrentReferenceHashMap.Restructure The types of restructuring that can be performed.
protected class	ConcurrentReferenceHashMap.Segment A single segment used to divide the map to allow better concurrent performance.

从类继承的嵌套类/接口 java.util.AbstractMap

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

构造器概要

构造器

构造器和说明
ConcurrentReferenceHashMap() Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity) Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity, ConcurrentReferenceHashMap.ReferenceType referenceType) Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor) Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel) Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel, ConcurrentReferenceHashMap.ReferenceType referenceType) Create a new ConcurrentReferenceHashMap instance.
ConcurrentReferenceHashMap(int initialCapacity, int concurrencyLevel) Create a new ConcurrentReferenceHashMap instance.

方法概要

限定符和类型	方法和说明
protected static int	calculateShift(int minimumValue, int maximumValue) Calculate a shift value that can be used to create a power-of-two value between the specified maximum and minimum values.
void	clear()
boolean	containsKey(java.lang.Object key)
protected ConcurrentReferenceHashMap.ReferenceManager	createReferenceManager() Factory method that returns the ConcurrentReferenceHashMap.ReferenceManager.
java.util.Set<java.util.Map.Entry<K,V>>	entrySet()
V	get(java.lang.Object key)
protected int	getHash(java.lang.Object o) Get the hash for a given object, apply an additional hash function to reduce collisions.
protected float	getLoadFactor()
protected ConcurrentReferenceHashMap.Reference<K,V>	getReference(java.lang.Object key, ConcurrentReferenceHashMap.Restructure restructure) Return a ConcurrentReferenceHashMap.Reference to the ConcurrentReferenceHashMap.Entry for the specified key, or null if not found.
protected ConcurrentReferenceHashMap.Segment	getSegment(int index)
protected int	getSegmentsSize()
void	purgeUnreferencedEntries() Remove any entries that have been garbage collected and are no longer referenced.
V	put(K key, V value)
V	putIfAbsent(K key, V value)
V	remove(java.lang.Object key)
boolean	remove(java.lang.Object key, java.lang.Object value)
V	replace(K key, V value)
boolean	replace(K key, V oldValue, V newValue)
int	size()

从类继承的方法 java.util.AbstractMap

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

从类继承的方法 java.lang.Object

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

从接口继承的方法 java.util.concurrent.ConcurrentMap

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, replaceAll

从接口继承的方法 java.util.Map

containsValue, equals, hashCode, isEmpty, keySet, putAll, values

构造器详细资料

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap()

Create a new ConcurrentReferenceHashMap instance.

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity)

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor)

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

loadFactor - the load factor. When the average number of references per table exceeds this value resize will be attempted

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  int concurrencyLevel)

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

concurrencyLevel - the expected number of threads that will concurrently write to the map

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  ConcurrentReferenceHashMap.ReferenceType referenceType)

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

referenceType - the reference type used for entries (soft or weak)

ConcurrentReferenceHashMap

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

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

loadFactor - the load factor. When the average number of references per table exceeds this value, resize will be attempted.

concurrencyLevel - the expected number of threads that will concurrently write to the map

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor,
                                  int concurrencyLevel,
                                  ConcurrentReferenceHashMap.ReferenceType referenceType)

Create a new ConcurrentReferenceHashMap instance.

参数:

initialCapacity - the initial capacity of the map

loadFactor - the load factor. When the average number of references per table exceeds this value, resize will be attempted.

concurrencyLevel - the expected number of threads that will concurrently write to the map

referenceType - the reference type used for entries (soft or weak)

方法详细资料

getLoadFactor

protected final float getLoadFactor()

getSegmentsSize

protected final int getSegmentsSize()

getSegment

protected final ConcurrentReferenceHashMap.Segment getSegment(int index)

createReferenceManager

protected ConcurrentReferenceHashMap.ReferenceManager createReferenceManager()

Factory method that returns the ConcurrentReferenceHashMap.ReferenceManager. This method will be called once for each ConcurrentReferenceHashMap.Segment.

返回:

a new reference manager

getHash

protected int getHash(java.lang.Object o)

Get the hash for a given object, apply an additional hash function to reduce collisions. This implementation uses the same Wang/Jenkins algorithm as ConcurrentHashMap. Subclasses can override to provide alternative hashing.

参数:

o - the object to hash (may be null)

返回:

the resulting hash code

get

public V get(java.lang.Object key)

指定者:

get 在接口中 java.util.Map<K,V>

覆盖:

get 在类中 java.util.AbstractMap<K,V>

containsKey

public boolean containsKey(java.lang.Object key)

指定者:

containsKey 在接口中 java.util.Map<K,V>

覆盖:

containsKey 在类中 java.util.AbstractMap<K,V>

getReference

protected final ConcurrentReferenceHashMap.Reference<K,V> getReference(java.lang.Object key,
                                                                       ConcurrentReferenceHashMap.Restructure restructure)

Return a ConcurrentReferenceHashMap.Reference to the ConcurrentReferenceHashMap.Entry for the specified key, or null if not found.

参数:

key - the key (can be null)

restructure - types of restructure allowed during this call

返回:

the reference, or null if not found

put

public V put(K key,
             V value)

指定者:

put 在接口中 java.util.Map<K,V>

覆盖:

put 在类中 java.util.AbstractMap<K,V>

putIfAbsent

public V putIfAbsent(K key,
                     V value)

指定者:

putIfAbsent 在接口中 java.util.concurrent.ConcurrentMap<K,V>

指定者:

putIfAbsent 在接口中 java.util.Map<K,V>

remove

public V remove(java.lang.Object key)

指定者:

remove 在接口中 java.util.Map<K,V>

覆盖:

remove 在类中 java.util.AbstractMap<K,V>

remove

public boolean remove(java.lang.Object key,
                      java.lang.Object value)

指定者:

remove 在接口中 java.util.concurrent.ConcurrentMap<K,V>

指定者:

remove 在接口中 java.util.Map<K,V>

replace

public boolean replace(K key,
                       V oldValue,
                       V newValue)

指定者:

replace 在接口中 java.util.concurrent.ConcurrentMap<K,V>

指定者:

replace 在接口中 java.util.Map<K,V>

replace

public V replace(K key,
                 V value)

指定者:

replace 在接口中 java.util.concurrent.ConcurrentMap<K,V>

指定者:

replace 在接口中 java.util.Map<K,V>

clear

public void clear()

指定者:

clear 在接口中 java.util.Map<K,V>

覆盖:

clear 在类中 java.util.AbstractMap<K,V>

purgeUnreferencedEntries

public void purgeUnreferencedEntries()

Remove any entries that have been garbage collected and are no longer referenced. Under normal circumstances garbage collected entries are automatically purged as items are added or removed from the Map. This method can be used to force a purge, and is useful when the Map is read frequently but updated less often.

size

public int size()

指定者:

size 在接口中 java.util.Map<K,V>

覆盖:

size 在类中 java.util.AbstractMap<K,V>

entrySet

public java.util.Set<java.util.Map.Entry<K,V>> entrySet()

指定者:

entrySet 在接口中 java.util.Map<K,V>

指定者:

entrySet 在类中 java.util.AbstractMap<K,V>

calculateShift

protected static int calculateShift(int minimumValue,
                                    int maximumValue)

Calculate a shift value that can be used to create a power-of-two value between the specified maximum and minimum values.

参数:

minimumValue - the minimum value

maximumValue - the maximum value

返回:

the calculated shift (use 1 << shift to obtain a value)