Hashtable

Hashtable

Hashtable (int initialCapacity, 
                float loadFactor)

用指定的初始容量和指定的加载因子构造一个新的空的散列表。

Hashtable

Hashtable (int initialCapacity)

用指定的初始容量和默认加载因子（0.75）构造一个新的空哈希表。

Hashtable

Hashtable ()

使用默认的初始容量（11）和加载因子（0.75）构造一个新的空哈希表。

Hashtable

Hashtable (Map<? extends K, ? extends V> t)

使用与给定Map相同的映射构造一个新的散列表。 散列表的初始容量足以容纳给定Map中的映射和默认加载因子（0.75）。

clear

void clear ()

清除这个散列表，以便它不包含任何键。

clone

Object clone ()

创建此散列表的浅表副本。 散列表本身的所有结构都被复制，但键和值不会被克隆。 这是一个相对昂贵的操作。

compute

V compute (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

尝试计算指定键和其当前映射值的映射（如果没有当前映射， null ）。 例如，要创建或附加一个String味精到值映射：

 map.compute(key, (k, v) -> (v == null) ? msg : v.concat(msg))

如果重新映射函数返回null ，映射将被删除（如果最初不存在，则保持不存在）。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

computeIfAbsent

V computeIfAbsent (K key, 
                Function<? super K, ? extends V> mappingFunction)

如果指定键尚未与值关联（或映射到 null ），则尝试使用给定的映射函数计算其值，并将其输入到此映射中，除非 null 。

如果映射函数返回null ，则不记录映射。 如果映射函数本身抛出（未经检查的）异常，则重新抛出异常，并且不记录映射。 最常见的用法是构造一个新的对象作为初始映射值或记忆结果，如下所示：

 map.computeIfAbsent(key, k -> new Value(f(k)));
 

或者实现一个多值映射 Map<K,Collection<V>> ，每个键支持多个值：

 map.computeIfAbsent(key, k -> new HashSet<V>()).add(v);
 

计算过程中映射函数不应修改此映射。

computeIfPresent

V computeIfPresent (K key, 
                BiFunction<? super K, ? super V, ? extends V> remappingFunction)

如果指定键的值存在且非空，则尝试计算给定键和其当前映射值的新映射。

如果重映射函数返回null ，则映射被移除。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

contains

boolean contains (Object value)

测试某个键是否映射到此散列表中的指定值。 该操作比containsKey方法更昂贵。

请注意，此方法在功能上与 containsValue （它是集合框架中的 Map接口的一部分） Map 。

containsKey

boolean containsKey (Object key)

测试指定的对象是否是此散列表中的键。

containsValue

boolean containsValue (Object value)

如果此散列表将一个或多个键映射到此值，则返回true。

请注意，此方法在功能上与 contains （它早于 Map接口）相同。

elements

Enumeration<V> elements ()

返回此散列表中值的枚举。 在返回的对象上使用Enumeration方法来顺序获取元素。

entrySet

Set<Entry<K, V>> entrySet ()

返回此映射中映射的映射的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 如果在对集合进行迭代的过程中修改了映射（除了通过迭代器自己的remove操作或通过对迭代器返回的映射条目执行setValue操作），迭代的结果是未定义的。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove，Set.remove，removeAll，retainAll clear和操作。 它不支持add或addAll操作。

equals

boolean equals (Object o)

按照Map接口中的定义，将指定的Object与此Map进行比较以获得相等性。

forEach

void forEach (BiConsumer<? super K, ? super V> action)

对此映射中的每个条目执行给定操作，直到处理完所有条目或操作抛出异常为止。 除非实现类另有规定，否则按照条目集迭代的顺序执行操作（如果指定了迭代顺序）。操作抛出的异常会中继给调用者。

get

V get (Object key)

返回指定键映射到的值，如果此映射不包含键映射，则返回 null 。

更正式地说，如果该映射包含从键k到值v的映射，例如(key.equals(k)) ，则该方法返回v ; 否则返回null 。 （最多可以有一个这样的映射。）

getOrDefault

V getOrDefault (Object key, 
                V defaultValue)

返回指定键映射到的值 defaultValue如果此映射不包含键映射，则返回 defaultValue 。

hashCode

int hashCode ()

根据Map界面中的定义返回此Map的哈希码值。

isEmpty

boolean isEmpty ()

测试这个哈希表是否没有将键映射到值。

keySet

Set<K> keySet ()

返回此映射中包含的键的Set视图。 该集合由地图支持，因此对地图的更改反映在集合中，反之亦然。 如果在对集合进行迭代的过程中修改了映射（除了通过迭代器自己的remove操作），迭代的结果是未定义的。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove，Set.remove，removeAll，retainAll，和clear操作。 它不支持add或addAll操作。

keys

Enumeration<K> keys ()

返回此散列表中键的枚举。

merge

V merge (K key, 
                V value, 
                BiFunction<? super V, ? super V, ? extends V> remappingFunction)

如果指定的键尚未与某个值关联或者与null关联，则将其与给定的非空值相关联。 否则，用给定的重映射函数的结果替换关联的值，或者如果结果为null ，则将其删除。 组合键的多个映射值时，此方法可能会有用。 例如，要创建或附加一个String msg到值映射：

 map.merge(key, msg, String::concat)
 

如果重映射函数返回null ，则映射将被删除。 如果重映射函数本身抛出一个（未经检查的）异常，则重新抛出异常，并且当前映射保持不变。

重新映射函数不应该在计算过程中修改此映射。

put

V put (K key, 
                V value)

将指定的key映射到此散列表中指定的value 。 关键和价值都不是null 。

可以通过使用与原始密钥相同的密钥调用 get方法来检索该值。

putAll

void putAll (Map<? extends K, ? extends V> t)

将指定映射中的所有映射复制到此散列表。 这些映射将替换此散列表对当前指定映射中的任何键的任何映射。

putIfAbsent

V putIfAbsent (K key, 
                V value)

如果指定的键尚未与值关联（或映射到 null ）， null其与给定值相关联并返回 null ，否则返回当前值。

remove

boolean remove (Object key, 
                Object value)

只有在指定键当前映射到指定值时，才删除该条目。

remove

V remove (Object key)

从该散列表中删除键（及其相应的值）。 如果密钥不在散列表中，此方法不执行任何操作。

replace

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

仅当当前映射到指定值时才替换指定键的条目。

replace

V replace (K key, 
                V value)

仅当指定键的条目映射到某个值时才替换该条目。

replaceAll

void replaceAll (BiFunction<? super K, ? super V, ? extends V> function)

用对该条目调用给定函数的结果替换每个条目的值，直到处理完所有条目或者该函数抛出异常。 函数抛出的异常会传递给调用者。

size

int size ()

返回此散列表中的键的数量。

toString

String toString ()

以一组条目形式返回此Hashtable对象的字符串表示形式，并用大括号括起来，并用ASCII字符“ ,  ”（逗号和空格）分隔。 每个条目呈现为密钥，等号=和关联元素，其中使用toString方法将密钥和元素转换为字符串。

values

Collection<V> values ()

返回此映射中包含的值的Collection视图。 该集合由地图支持，因此地图的更改会反映在集合中，反之亦然。 如果在对集合进行迭代的过程中修改了映射（除了通过迭代器自己的remove操作），迭代的结果是未定义的。 该collection支持元素移除，即从映射中相应的映射，经由Iterator.remove，Collection.remove，removeAll，retainAll clear和操作。 它不支持add或addAll操作。

rehash

void rehash ()

增加散列表的容量并在内部重新组织，以便更有效地容纳和访问条目。 当散列表中的键数超过散列表的容量和加载因子时，将自动调用此方法。