Java java.util 类 WeakHashMap<K,V>（JDK5）

所有类

java.util
类 WeakHashMap<K,V>

java.lang.Object
  java.util.AbstractMap<K,V>
      java.util.WeakHashMap<K,V>

所有已实现的接口：

Map<K,V>

public class WeakHashMap<K,V>
   
   
   
   
   
extends AbstractMap<K,V>
   
   
   
   
   
   
   
   
   
   
implements Map<K,V>
   
   
   
   
   

以弱键 实现的基于哈希表的 Map。在 WeakHashMap 中，当某个键不再正常使用时，将自动移除其条目。更精确地说，对于一个给定的键，其映射的存在并不阻止垃圾回收器对该键的丢弃，这就使该键成为可终止的，被终止，然后被回收。丢弃某个键时，其条目从映射中有效地移除，因此，该类的行为与其他的 Map 实现有所不同。

null 值和 null 键都被支持。该类具有与 HashMap 类相似的性能特征,并具有相同的效能参数初始容量 和加载因子。

像大多数集合类一样，该类是不同步的。可以使用 Collections.synchronizedMap 方法来构造同步的 WeakHashMap。

该类主要与这样的键对象一起使用，其 equals 方法使用 == 运算符来测试对象标识。一旦这种键被丢弃，就永远无法再创建了，所以，过段时间后在 WeakHashMap 中查找此键是不可能的，不必对其项已移除而感到惊讶。该类十分适合与 equals 方法不是基于对象标识的键对象一起使用，比如，String 实例。然而，对于这种可重新创建的键对象，键若丢弃，就自动移除 WeakHashMap 条目，这种表现令人疑惑。

WeakHashMap 类的行为部分取决于垃圾回收器的动作，所以，几个常见的（虽然不是必需的）Map 常量不支持此类。因为垃圾回收器在任何时候都可能丢弃键，WeakHashMap 就像是一个被悄悄移除条目的未知线程。特别地，即使对 WeakHashMap 实例进行同步，并且没有调用任何赋值方法，在一段时间后 size 方法也可能返回较小的值，对于 isEmpty 方法，返回 false，然后返回 true，对于给定的键，containsKey 方法返回 true 然后返回 false，对于给定的键，get 方法返回一个值，但接着返回 null，对于以前出现在映射中的键，put 方法返回 null，而 remove 方法返回 false，对于键集、值集、项集进行的检查，生成的元素数量越来越少。

WeakHashMap 中的每个键对象间接地存储为一个弱引用的指示对象。因此，不管是在映射内还是在映射之外，只有在垃圾回收器清除某个键的弱引用之后，该键才会自动移除。

实现注意事项：WeakHashMap 中的值对象由普通的强引用保持。因此应该小心谨慎，确保值对象不会直接或间接地强引用其自身的键，因为这会阻止键的丢弃。注意，值对象可以通过 WeakHashMap 本身间接引用其对应的键；这就是说，某个值对象可能强引用某个其他的键对象，而与该键对象相关联的值对象转而强引用第一个值对象的键。处理此问题的一种方法是，在插入前将值自身包装在 WeakReferences 中，如：m.put(key, new WeakReference(value))，然后，分别用 get 进行解包。

该类所有“collection 视图方法”返回的迭代器均是快速失败的：在迭代器创建之后，如果从结构上对映射进行修改，除非通过迭代器自身的 remove 或 add 方法,其他任何时间任何方式的修改，迭代器都将抛出 ConcurrentModificationException。因此，面对并发的修改，迭代器很快就完全失败，而不是冒着在将来不确定的时间任意发生不确定行为的风险。

注意，迭代器的快速失败行为不能得到保证，一般来说，存在不同步的并发修改时，不可能作出任何坚决的保证。快速失败迭代器尽最大努力抛出 ConcurrentModificationException。因此，编写依赖于此异常程序的方式是错误的，正确做法是：迭代器的快速失败行为应该仅用于检测 bug。

此类是 Java Collections Framework 的成员。

从以下版本开始：

1.2

另请参见：

HashMap, WeakReference

WeakHashMap

public WeakHashMap(int initialCapacity,
                   float loadFactor)

用给定的初始容量和加载因子构造一个新的空 WeakHashMap。

参数：

initialCapacity - WeakHashMap 的初始容量

loadFactor - WeakHashMap 的加载因子

抛出：

IllegalArgumentException - 如果初始容量为负，或加载因子为非正。

WeakHashMap

public WeakHashMap(int initialCapacity)

用给定的初始容量和默认加载因子 0.75 构造一个新的空 WeakHashMap。

参数：

initialCapacity - WeakHashMap 的初始容量

抛出：

IllegalArgumentException - 如果初始容量为负。

WeakHashMap

public WeakHashMap()

用默认初始容量 (16) 和默认加载因子 (0.75) 构造一个新的空 WeakHashMap。

WeakHashMap

public WeakHashMap(Map<? extends K,? extends V> t)

用与指定的 Map 相同的映射关系构造一个新 WeakHashMap。用默认的加载因子（0.75）创建 WeakHashMap，初始容量足以容纳指定 Map 中的映射关系。

参数：

t - 映射，其映射关系将存放在此映射中。

抛出：

NullPointerException - 如果指定的映射为 null。

从以下版本开始：

1.3

size

public int size()

返回该映射中的键-值映射关系的数目。此结果是个快照，可能无法反映未处理的项，这些项因为不再引用而在下次试图访问前被移除。

指定者：

接口 Map<K,V> 中的 size

覆盖：

类 AbstractMap<K,V> 中的 size

返回：

此映射中键-值映射关系的数量。

isEmpty

public boolean isEmpty()

如果此映射不包含键-值映射关系，则返回 true。此结果是个快照，可能无法反映未处理的项，这些项因为不再引用而在下次访问前被移除。

指定者：

接口 Map<K,V> 中的 isEmpty

覆盖：

类 AbstractMap<K,V> 中的 isEmpty

返回：

如果此映射不包含任何键-值映射关系，则返回 true。

get

public V get(Object key)

返回指定键在此弱哈希映射中所映射的值，如果对于该键来说，映射不包含任何映射关系，则返回 null。返回值为 null 并不一定 表示对于该键来说，映射不包含任何映射关系；也可能是映射显式地将键映射到 null。使用 containsKey 方法可以区分这两种情况。

指定者：

接口 Map<K,V> 中的 get

覆盖：

类 AbstractMap<K,V> 中的 get

参数：

key - 与要返回的值相关联的键。

返回：

此映射对于指定键所映射的值，如果此映射对于该键不包含任何映射关系，则返回 null。

另请参见：

put(Object, Object)

containsKey

public boolean containsKey(Object key)

如果此映射对于指定的键包含映射关系，则返回 true。

指定者：

接口 Map<K,V> 中的 containsKey

覆盖：

类 AbstractMap<K,V> 中的 containsKey

参数：

key - 要测试其是否在此映射中存在的键

返回：

如果有 key 的映射关系，则返回 true，否则返回 false。