程序包 cc.shacocloud.mirage.utils.map

类 ConcurrentReferenceHashMap<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

cc.shacocloud.mirage.utils.map.ConcurrentReferenceHashMap<K,V>

所有已实现的接口:

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

public class ConcurrentReferenceHashMap<K,V>
extends AbstractMap<K,V>
implements ConcurrentMap<K,V>

一个(弱/软)引用的并发 HashMap

参考 spring

嵌套类概要

嵌套类

修饰符和类型	类	说明
protected static class	ConcurrentReferenceHashMap.Entry<K,V>	单个地图条目
protected static interface	ConcurrentReferenceHashMap.Reference<K,V>	对映射中包含的 ConcurrentReferenceHashMap.Entry 的引用。
protected class	ConcurrentReferenceHashMap.ReferenceManager	用于管理ConcurrentReferenceHashMap.Reference的策略类。
static class	ConcurrentReferenceHashMap.ReferenceType	此地图支持的各种参考类型
protected static class	ConcurrentReferenceHashMap.Restructure	可以进行的结构调整的类型。
protected class	ConcurrentReferenceHashMap.Segment	用于划分映射以允许更好的并发性能的单个段

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

AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>

构造器概要

构造器

构造器	说明
ConcurrentReferenceHashMap()	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity)	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor)	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel)	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity, float loadFactor, int concurrencyLevel, ConcurrentReferenceHashMap.ReferenceType referenceType)	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity, int concurrencyLevel)	创建一个新的 ConcurrentReferenceHashMap 实例
ConcurrentReferenceHashMap(int initialCapacity, ConcurrentReferenceHashMap.ReferenceType referenceType)	创建一个新的 ConcurrentReferenceHashMap 实例

方法概要

修饰符和类型	方法	说明
protected static int	calculateShift(int minimumValue, int maximumValue)	计算可用于在指定的最大值和最小值之间创建 2 次幂值的偏移值。
void	clear()
boolean	containsKey(@Nullable Object key)
protected ConcurrentReferenceHashMap.ReferenceManager	createReferenceManager()	返回 ConcurrentReferenceHashMap.ReferenceManager 的工厂方法。
Set<Map.Entry<K,V>>	entrySet()
V	get(@Nullable Object key)
protected int	getHash(@Nullable Object o)	获取给定对象的哈希值，应用额外的哈希函数以减少冲突。
protected float	getLoadFactor()
V	getOrDefault(@Nullable Object key, V defaultValue)
protected @Nullable ConcurrentReferenceHashMap.Reference<K,V>	getReference(@Nullable Object key, ConcurrentReferenceHashMap.Restructure restructure)	为指定的 键 返回 ConcurrentReferenceHashMap.Reference 的 ConcurrentReferenceHashMap.Entry，如果未找到，则返回 null
protected ConcurrentReferenceHashMap.Segment	getSegment(int index)
protected int	getSegmentsSize()
boolean	isEmpty()
void	purgeUnreferencedEntries()	删除任何已被垃圾回收且不再引用的条目。
V	put(K key, V value)
V	putIfAbsent(K key, V value)
V	remove(@Nullable Object key)
boolean	remove(@Nullable Object key, @Nullable 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, keySet, putAll, toString, values

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

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

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

compute, computeIfAbsent, computeIfPresent, forEach, merge, replaceAll

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

containsValue, equals, hashCode, keySet, putAll, values

构造器详细资料

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap()

创建一个新的 ConcurrentReferenceHashMap 实例

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity)

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  float loadFactor)

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

loadFactor - 负载系数。当每个表的平均引用数超过此值时，将尝试调整大小

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  int concurrencyLevel)

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

concurrencyLevel - 将同时写入映射的预期线程数

ConcurrentReferenceHashMap

public ConcurrentReferenceHashMap(int initialCapacity,
                                  ConcurrentReferenceHashMap.ReferenceType referenceType)

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

referenceType - 用于条目的引用类型（软或弱）

ConcurrentReferenceHashMap

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

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

loadFactor - 负载系数。当每个表的平均引用数超过此值时，将尝试调整大小

concurrencyLevel - 将同时写入映射的预期线程数

ConcurrentReferenceHashMap

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

创建一个新的 ConcurrentReferenceHashMap 实例

参数:

initialCapacity - 地图的初始容量

loadFactor - 负载系数。当每个表的平均引用数超过此值时，将尝试调整大小

concurrencyLevel - 将同时写入映射的预期线程数

referenceType - 用于条目的引用类型（软或弱）

方法详细资料

getLoadFactor

protected final float getLoadFactor()

getSegmentsSize

protected final int getSegmentsSize()

getSegment

protected final ConcurrentReferenceHashMap.Segment getSegment(int index)

createReferenceManager

protected ConcurrentReferenceHashMap.ReferenceManager createReferenceManager()

返回 ConcurrentReferenceHashMap.ReferenceManager 的工厂方法。此方法将为每个ConcurrentReferenceHashMap.Segment调用一次。

getHash

protected int getHash(@Nullable
                      @Nullable Object o)

获取给定对象的哈希值，应用额外的哈希函数以减少冲突。此实现使用与 相同的 ConcurrentHashMapWang/Jenkins 算法。子类可以覆盖以提供替代哈希。 形参:

参数:

o - 要哈希的对象（可能为空）

返回:

生成的哈希代码.

get

@Nullable
public V get(@Nullable
             @Nullable Object key)

指定者:

get 在接口中 Map<K,V>

覆盖:

get 在类中 AbstractMap<K,V>

getOrDefault

@Nullable
public V getOrDefault(@Nullable
                      @Nullable Object key,
                      @Nullable
                      V defaultValue)

指定者:

getOrDefault 在接口中 ConcurrentMap<K,V>

指定者:

getOrDefault 在接口中 Map<K,V>

containsKey

public boolean containsKey(@Nullable
                           @Nullable Object key)

指定者:

containsKey 在接口中 Map<K,V>

覆盖:

containsKey 在类中 AbstractMap<K,V>

getReference

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

为指定的 键 返回 ConcurrentReferenceHashMap.Reference 的 ConcurrentReferenceHashMap.Entry，如果未找到，则返回 null

参数:

key - 键（可以是 空）

restructure - 此调用期间允许的重组类型

返回:

引用，如果未找到，则为 null

put

@Nullable
public V put(@Nullable
             K key,
             @Nullable
             V value)

指定者:

put 在接口中 Map<K,V>

覆盖:

put 在类中 AbstractMap<K,V>

putIfAbsent

@Nullable
public V putIfAbsent(@Nullable
                     K key,
                     @Nullable
                     V value)

指定者:

putIfAbsent 在接口中 ConcurrentMap<K,V>

指定者:

putIfAbsent 在接口中 Map<K,V>

remove

@Nullable
public V remove(@Nullable
                @Nullable Object key)

指定者:

remove 在接口中 Map<K,V>

覆盖:

remove 在类中 AbstractMap<K,V>

remove

public boolean remove(@Nullable
                      @Nullable Object key,
                      @Nullable
                      @Nullable Object value)

指定者:

remove 在接口中 ConcurrentMap<K,V>

指定者:

remove 在接口中 Map<K,V>

replace

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

指定者:

replace 在接口中 ConcurrentMap<K,V>

指定者:

replace 在接口中 Map<K,V>

replace

@Nullable
public V replace(@Nullable
                 K key,
                 @Nullable
                 V value)

指定者:

replace 在接口中 ConcurrentMap<K,V>

指定者:

replace 在接口中 Map<K,V>

clear

public void clear()

指定者:

clear 在接口中 Map<K,V>

覆盖:

clear 在类中 AbstractMap<K,V>

purgeUnreferencedEntries

public void purgeUnreferencedEntries()

删除任何已被垃圾回收且不再引用的条目。在正常情况下，垃圾回收条目会在地图中添加或删除项目时自动清除。此方法可用于强制清除，当 Map 频繁读取但更新频率较低时非常有用。

size

public int size()

指定者:

size 在接口中 Map<K,V>

覆盖:

size 在类中 AbstractMap<K,V>

isEmpty

public boolean isEmpty()

指定者:

isEmpty 在接口中 Map<K,V>

覆盖:

isEmpty 在类中 AbstractMap<K,V>

entrySet

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

指定者:

entrySet 在接口中 Map<K,V>

指定者:

entrySet 在类中 AbstractMap<K,V>

calculateShift

protected static int calculateShift(int minimumValue,
                                    int maximumValue)

计算可用于在指定的最大值和最小值之间创建 2 次幂值的偏移值。

参数:

minimumValue - 最小值

maximumValue - 最大值

返回:

计算的偏移（使用 1 << 偏移 获取值）