java.lang.Object
|---java.util.AbstractMap<K,V&
|---|---java.util.WeakHashMap<K,V&
public class WeakHashMap<K,V>
extends AbstractMap<K,V>
implements Map<K,V>
Map 接口的基于哈希表的实现，带有弱键。 WeakHashMap 中的条目在其键不再常用时将被自动删除。 更准确地说，给定键的映射的存在不会阻止该键被垃圾收集器丢弃，也就是说，使其可终结，最终确定，然后回收。 当一个键被丢弃时，它的条目被有效地从映射中删除，所以这个类的行为与其他映射实现有些不同。
支持空值和空键。 该类具有与HashMap类相似的性能特点，并且具有相同的初始容量和负载因子的效率参数。
像大多数集合类一样，这个类是不同步的。 可以使用 Collections#synchronizedMap 方法构造同步的 WeakHashMap。
此类主要用于关键对象，其 equals 方法使用 == 运算符测试对象身份。 一旦这样的键被丢弃，它就永远无法重新创建，因此以后不可能在 WeakHashMap 中查找该键并惊讶于它的条目已被删除。 此类将非常适用于其 equals 方法不基于对象标识的关键对象，例如 String 实例。 然而，使用这种可重新创建的键对象，自动删除键已被丢弃的 WeakHashMap 条目可能会令人困惑。
WeakHashMap 类的行为部分取决于垃圾收集器的行为，因此一些熟悉的（尽管不是必需的）Map 不变量不适用于此类。 因为垃圾收集器可能随时丢弃键，所以 WeakHashMap 可能表现得好像一个未知线程正在默默地删除条目。 特别是，即使您在 WeakHashMap 实例上进行同步并且不调用它的任何 mutator 方法，size 方法也有可能随着时间的推移返回较小的值，isEmpty 方法返回 false 然后返回 true，containsKey 方法返回 给定键的 true 和 false，get 方法返回给定键的值，但稍后返回 null，put 方法返回 null，remove 方法返回 false，之前出现在 映射，并用于对键集、值集合和条目集的连续检查，以产生连续较少数量的元素。
WeakHashMap 中的每个键对象都间接存储为弱引用的所指对象。 因此，只有在映射内部和外部的弱引用已被垃圾收集器清除后，才会自动删除键。
实现说明：WeakHashMap 中的值对象由普通的强引用保存。 因此，应注意确保值对象不会直接或间接地强烈引用它们自己的键，因为这将防止键被丢弃。 请注意，值对象可以通过 WeakHashMap 本身间接引用其键； 也就是说，一个值对象可以强引用某个其他键对象，其关联的值对象反过来又强引用第一个值对象的键。 如果映射中的值不依赖于持有对它们的强引用的映射，解决此问题的一种方法是在插入之前将值本身包装在 WeakReferences 中，如：m.put(key, new WeakReference(value)), 然后在每次获取时打开包装。
由此类的所有“集合视图方法”返回的集合的迭代器方法返回的迭代器是快速失败的：如果在创建迭代器后的任何时间对映射进行结构修改，除了通过迭代器自己的删除之外的任何方式 方法，迭代器将抛出 ConcurrentModificationException。 因此，面对并发修改，迭代器快速而干净地失败，而不是在未来不确定的时间冒任意的、非确定性的行为。
请注意，不能保证迭代器的快速失败行为，因为一般来说，在存在不同步的并发修改的情况下，不可能做出任何硬保证。 快速失败的迭代器会尽最大努力抛出 ConcurrentModificationException。 因此，编写一个依赖于这个异常的正确性的程序是错误的：迭代器的快速失败行为应该只用于检测错误。
此类是 Java 集合框架的成员。
| 从类 java.util.AbstractMap 继承的嵌套类/接口 |
|---|
| AbstractMap.SimpleEntryK,V, AbstractMap.SimpleImmutableEntryK,V |
| 从接口 java.util.Map 继承的嵌套类/接口 |
|---|
| Map.EntryK,V |
| 构造函数 | 描述 |
|---|---|
| WeakHashMap() | 构造一个具有默认初始容量 (16) 和加载因子 (0.75) 的新的空 WeakHashMap。 |
| WeakHashMap(int initialCapacity) | 使用给定的初始容量和默认加载因子 (0.75) 构造一个新的空 WeakHashMap。 |
| WeakHashMap(int initialCapacity, float loadFactor) | 使用给定的初始容量和给定的负载因子构造一个新的空 WeakHashMap。 |
| WeakHashMap(Map<? extends K,? extends V> m) | 构造一个与指定映射具有相同映射的新 WeakHashMap。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | clear() | 从此 map 中删除所有映射。 |
| boolean | containsKey(Object key) | 如果此映射包含指定键的映射，则返回 true。 |
| boolean | containsValue(Object value) | 如果此映射将一个或多个键映射到指定值，则返回 true。 |
| SetMap.EntryK,V | entrySet() | 返回此映射中包含的映射的 Set 视图。 |
| void | forEach(BiConsumer<? super K,? super V> action) | 对该映射中的每个条目执行给定的操作，直到处理完所有条目或该操作引发异常。 |
| V | get(Object key) | 返回指定键映射到的值，如果此映射不包含该键的映射，则返回 null。 |
| boolean | isEmpty() | 如果此映射不包含键值映射，则返回 true。 |
| SetK | keySet() | 返回此映射中包含的键的 Set 视图。 |
| V | put(K key, V value) | 将指定的值与此映射中的指定键相关联。 |
| void | putAll(Map<? extends K,? extends V> m) | 将所有映射从指定映射复制到此映射。 |
| V | remove(Object key) | 如果存在，则从此弱哈希映射中删除键的映射。 |
| void | replaceAll(BiFunction<? super K,? super V,? extends V> function) | 将每个条目的值替换为对该条目调用给定函数的结果，直到所有条目都已处理或该函数引发异常。 |
| int | size() | 返回此映射中键值映射的数量。 |
| CollectionV | values() | 返回此映射中包含的值的集合视图。 |
| 从类 java.util.AbstractMap 继承的方法 |
|---|
| clone, equals, hashCode, toString |
| 从接口 java.util.Map 继承的方法 |
|---|
| compute, computeIfAbsent, computeIfPresent, equals, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace |
| 从类 java.lang.Object 继承的方法 |
|---|
| finalize, getClass, notify, notifyAll, wait, wait, wait |
public WeakHashMap(int initialCapacity, float loadFactor)
使用给定的初始容量和给定的负载因子构造一个新的空 WeakHashMap。
参数：
| 参数名称 | 参数描述 |
|---|---|
| initialCapacity | WeakHashMap的初始容量 |
| loadFactor | WeakHashMap 的负载因子 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果初始容量为负数，或者负载因子为非正数。 |
public WeakHashMap(int initialCapacity)
使用给定的初始容量和默认加载因子 (0.75) 构造一个新的空 WeakHashMap。
参数：
| 参数名称 | 参数描述 |
|---|---|
| initialCapacity | WeakHashMap的初始容量 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果初始容量为负 |
public WeakHashMap()
构造一个具有默认初始容量 (16) 和加载因子 (0.75) 的新的空 WeakHashMap。
public WeakHashMap(Map<? extends K,? extends V> m)
构造一个与指定映射具有相同映射的新 WeakHashMap。 WeakHashMap 是使用默认加载因子 (0.75) 和足以在指定映射中保存映射的初始容量创建的。
参数：
| 参数名称 | 参数描述 |
|---|---|
| m | 其映射将放置在此 map 中的 map |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果指定的 map 为空 |
public int size()
返回此映射中键值映射的数量。 此结果是一个快照，可能不会反映在下次尝试访问之前将被删除的未处理条目，因为它们不再被引用。
指定者：
接口 MapK,V 中的大小
覆盖：
AbstractMapK,V 类中的大小
返回:
此映射中的键值映射的数量
public boolean isEmpty()
如果此映射不包含键值映射，则返回 true。 此结果是一个快照，可能不会反映在下次尝试访问之前将被删除的未处理条目，因为它们不再被引用。
指定者：
接口 MapK,V 中的 isEmpty
覆盖：
AbstractMapK,V 类中的 isEmpty
返回:
如果此映射不包含键值映射，则为 true
public V get(Object key)
返回指定键映射到的值，如果此映射不包含该键的映射，则返回 null。
更正式地说，如果此映射包含从键 k 到值 v 的映射，使得 (key==null ? k==null : key.equals(k))，则此方法返回 v； 否则返回null。 （最多可以有一个这样的映射。）
返回值为 null 并不一定表示该映射不包含该键的映射； 映射也可能将键显式映射为空。 containsKey 操作可用于区分这两种情况。
指定者：
进入接口 MapK,V
覆盖：
进入类 AbstractMapK,V
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 要返回其关联值的键 |
返回:
指定键映射到的值，如果此映射不包含该键的映射，则为 null
public boolean containsKey(Object key)
如果此映射包含指定键的映射，则返回 true。
指定者：
containsKey 在接口 MapK,V
覆盖：
类 AbstractMapK,V 中的 containsKey
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 要测试在此映射中是否存在的键 |
返回:
如果存在键映射，则为 true； 否则为 false
public V put(K key, V value)
将指定的值与此映射中的指定键相关联。 如果映射先前包含此键的映射，则替换旧值。
指定者：
放入接口 MapK,V
覆盖：
放入类 AbstractMapK,V
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 与指定值关联的键。 |
| value | 与指定键关联的值。 |
返回:
与 key 关联的前一个值，如果没有 key 映射，则返回 null。 （返回 null 还可以指示映射先前将 null 与 key 关联。）
public void putAll(Map<? extends K,? extends V> m)
将所有映射从指定映射复制到此映射。 这些映射将替换此映射对当前指定映射中的任何键的任何映射。
指定者：
putAll在接口MapK,V中
覆盖：
putAll 在类 AbstractMapK,V
参数：
| 参数名称 | 参数描述 |
|---|---|
| m | 要存储在此映射中的映射。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果指定的 map 为空。 |
public V remove(Object key)
如果存在，则从此弱哈希映射中删除键的映射。 更正式地说，如果此映射包含从键 k 到值 v 的映射，使得 (key==null ? k==null : key.equals(k))，则删除该映射。 （地图最多可以包含一个这样的映射。）
返回此映射先前与键关联的值，如果映射不包含键的映射，则返回 null。 返回值为 null 并不一定表示该映射不包含该键的映射； map 也有可能将键显式映射为空。
一旦调用返回，映射将不包含指定键的映射。
指定者：
在接口 MapK,V 中移除
覆盖：
在类 AbstractMapK,V 中删除
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 要从映射中删除其映射的键 |
返回:
与键关联的前一个值，如果没有键映射，则返回 null
public void clear()
从此 map 中删除所有映射。 此调用返回后，map 将为空。
指定者：
在界面 MapK,V 中清除
覆盖：
在类 AbstractMapK,V 中清除
public boolean containsValue(Object value)
如果此映射将一个或多个键映射到指定值，则返回 true。
指定者：
接口 MapK,V 中的 containsValue
覆盖：
类 AbstractMapK,V 中的 containsValue
参数：
| 参数名称 | 参数描述 |
|---|---|
| value | 要测试其在此映射中的存在的值 |
返回:
如果此映射将一个或多个键映射到指定值，则为 true
public SetK keySet()
返回此映射中包含的键的 Set 视图。 集合由 map 支持，因此对 map 的更改会反映在集合中，反之亦然。 如果在对集合进行迭代时修改了映射（通过迭代器自己的删除操作除外），则迭代的结果是不确定的。 该集合支持元素移除，即通过 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作从映射中移除相应的映射。 它不支持 add 或 addAll 操作。
指定者：
接口 MapK,V 中的 keySet
覆盖：
AbstractMapK,V 类中的 keySet
返回:
此 map 中包含的键的集合视图
public CollectionV values()
返回此映射中包含的值的集合视图。 集合由 map 支持，因此对 map 的更改会反映在集合中，反之亦然。 如果在对集合进行迭代时修改了映射（通过迭代器自己的删除操作除外），则迭代的结果是不确定的。 该集合支持元素移除，即通过 Iterator.remove、Collection.remove、removeAll、retainAll 和 clear 操作从映射中移除相应的映射。 它不支持 add 或 addAll 操作。
指定者：
接口 MapK,V 中的值
覆盖：
AbstractMapK,V 类中的值
返回:
此 map 中包含的值的集合视图
public SetMap.EntryK,V entrySet()
返回此映射中包含的映射的 Set 视图。 集合由 map 支持，因此对 map 的更改会反映在集合中，反之亦然。 如果在对集合进行迭代时修改了映射（通过迭代器自己的删除操作或通过迭代器返回的映射条目上的 setValue 操作除外），则迭代的结果是未定义的。 该集合支持元素移除，即通过 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作从映射中移除相应的映射。 它不支持 add 或 addAll 操作。
指定者：
接口 MapK,V 中的 entrySet
指定者：
AbstractMapK,V 类中的 entrySet
返回:
此 map 中包含的映射的集合视图
public void forEach(BiConsumer<? super K,? super V> action)
从接口复制的描述：map
对该映射中的每个条目执行给定的操作，直到处理完所有条目或该操作引发异常。 除非实现类另有规定，否则按照条目集迭代的顺序执行动作（如果指定了迭代顺序）。动作抛出的异常将转发给调用者。
指定者：
接口 MapK,V 中的 forEach
参数：
| 参数名称 | 参数描述 |
|---|---|
| action | 为每个条目执行的操作 |
public void replaceAll(BiFunction<? super K,? super V,? extends V> function)
从接口复制的描述：map
将每个条目的值替换为对该条目调用给定函数的结果，直到所有条目都已处理或该函数引发异常。 函数抛出的异常被转发给调用者。
指定者：
接口 MapK,V 中的 replaceAll
参数：
| 参数名称 | 参数描述 |
|---|---|
| function | 应用于每个条目的函数 |
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。