|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.util.AbstractMap<K,V> java.util.WeakHashMap<K,V>
public class WeakHashMap<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 的成员。
HashMap
,
WeakReference
构造方法摘要 | |
---|---|
WeakHashMap()
用默认初始容量 (16) 和默认加载因子 (0.75) 构造一个新的空 WeakHashMap。 |
|
WeakHashMap(int initialCapacity)
用给定的初始容量和默认加载因子 0.75 构造一个新的空 WeakHashMap。 |
|
WeakHashMap(int initialCapacity,
float loadFactor)
用给定的初始容量和加载因子构造一个新的空 WeakHashMap。 |
|
WeakHashMap(Map<? extends K,? extends V> t)
用与指定的 Map 相同的映射关系构造一个新 WeakHashMap。 |
方法摘要 | |
---|---|
void |
clear()
从该映射中移除所有映射关系。 |
boolean |
containsKey(Object key)
如果此映射对于指定的键包含映射关系,则返回 true。 |
boolean |
containsValue(Object value)
如果此映射将一个或多个键映射到指定值,则返回 true。 |
Set<Map.Entry<K,V>> |
entrySet()
返回此映射所包含的映射关系的 collection 视图。 |
V |
get(Object key)
返回指定键在此弱哈希映射中所映射的值,如果对于该键来说,映射不包含任何映射关系,则返回 null。 |
boolean |
isEmpty()
如果此映射不包含键-值映射关系,则返回 true。 |
Set<K> |
keySet()
返回此映射所包含的键的 set 视图。 |
V |
put(K key,
V value)
关联此映射中的指定值与指定键。 |
void |
putAll(Map<? extends K,? extends V> m)
将指定映射的全部映射关系复制到此映射,这些映射关系将替换此映射针对当前指定映射中任何键所具有的任何映射关系。 |
V |
remove(Object key)
如果存在,则删除此映射中键的映射关系。 |
int |
size()
返回该映射中的键-值映射关系的数目。 |
Collection<V> |
values()
返回此映射所包含的值的 collection 视图。 |
从类 java.util.AbstractMap 继承的方法 |
---|
clone, equals, hashCode, toString |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
从接口 java.util.Map 继承的方法 |
---|
equals, hashCode |
构造方法详细信息 |
---|
public WeakHashMap(int initialCapacity, float loadFactor)
initialCapacity
- WeakHashMap 的初始容量loadFactor
- WeakHashMap 的加载因子
IllegalArgumentException
- 如果初始容量为负,或加载因子为非正。public WeakHashMap(int initialCapacity)
initialCapacity
- WeakHashMap 的初始容量
IllegalArgumentException
- 如果初始容量为负。public WeakHashMap()
public WeakHashMap(Map<? extends K,? extends V> t)
t
- 映射,其映射关系将存放在此映射中。
NullPointerException
- 如果指定的映射为 null。方法详细信息 |
---|
public int size()
Map<K,V>
中的 size
AbstractMap<K,V>
中的 size
public boolean isEmpty()
Map<K,V>
中的 isEmpty
AbstractMap<K,V>
中的 isEmpty
public V get(Object key)
Map<K,V>
中的 get
AbstractMap<K,V>
中的 get
key
- 与要返回的值相关联的键。
put(Object, Object)
public boolean containsKey(Object key)
Map<K,V>
中的 containsKey
AbstractMap<K,V>
中的 containsKey
key
- 要测试其是否在此映射中存在的键
public V put(K key, V value)
Map<K,V>
中的 put
AbstractMap<K,V>
中的 put
key
- 指定值将要关联的键。value
- 指定键将要关联的值。
public void putAll(Map<? extends K,? extends V> m)
Map<K,V>
中的 putAll
AbstractMap<K,V>
中的 putAll
m
- 要在此映射中存储的映射关系。
NullPointerException
- 如果指定的映射为 null。public V remove(Object key)
Map<K,V>
中的 remove
AbstractMap<K,V>
中的 remove
key
- 其映射关系要从映射中移除的键。
public void clear()
Map<K,V>
中的 clear
AbstractMap<K,V>
中的 clear
public boolean containsValue(Object value)
Map<K,V>
中的 containsValue
AbstractMap<K,V>
中的 containsValue
value
- 要测试其是否在此映射中存在的值。
public Set<K> keySet()
Map<K,V>
中的 keySet
AbstractMap<K,V>
中的 keySet
public Collection<V> values()
Map<K,V>
中的 values
AbstractMap<K,V>
中的 values
public Set<Map.Entry<K,V>> entrySet()
Map<K,V>
中的 entrySet
AbstractMap<K,V>
中的 entrySet
Map.Entry
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。