ConcurrentHashMap.KeySetView

add

boolean add (K e)

如果已定义，则通过将密钥映射到支持映射中的默认映射值，将指定的密钥添加到此设置视图。

addAll

boolean addAll (Collection<? extends K> c)

将指定集合中的所有元素添加到此集合，就像通过每个元素调用 add(E) 。

clear

void clear ()

通过从支持该视图的地图中删除所有映射，从该视图中移除所有元素。

contains

boolean contains (Object o)

如果此集合包含指定的元素，则返回true 。 更正式地说，返回true当且仅当该集合包含至少一个元素e，例如(o==null ? e==null : o.equals(e)) 。

containsAll

boolean containsAll (Collection<?> c)

如果此集合包含指定集合中的所有元素，则返回 true 。

equals

boolean equals (Object o)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系：

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

类Object的equals方法实现了对象上最可能的等价关系; 也就是说，对于任何非空参考值x和y ，当且仅当x和y引用同一对象（ x == y的值为true ）时，此方法返回true 。

请注意，无论何时覆盖此方法，通常都必须覆盖 hashCode方法，以便维护 hashCode方法的一般合同，该方法声明相等对象必须具有相同的哈希代码。

forEach

void forEach (Consumer<? super K> action)

getMap

ConcurrentHashMap<K, V> getMap ()

返回支持此视图的地图。

getMappedValue

V getMappedValue ()

返回添加的默认映射值，如果不支持添加，则返回 null 。

hashCode

int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持该方法，例如由HashMap提供的HashMap 。

hashCode的总合同是：

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用，类Object定义的hashCode方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但Java ^TM编程语言不需要此实现技术。）

isEmpty

boolean isEmpty ()

如果此集合不包含元素，则返回 true 。

iterator

Iterator<K> iterator ()

返回此集合中元素的迭代器。

返回的迭代器是 weakly consistent 。

remove

boolean remove (Object o)

通过从备份映射中除去键（及其相应的值），从该映射视图中除去键。 如果该键不在地图中，该方法不执行任何操作。

removeAll

boolean removeAll (Collection<?> c)

删除指定集合中包含的所有此集合的元素（可选操作）。 此调用返回后，此集合将不包含与指定集合相同的元素。

retainAll

boolean retainAll (Collection<?> c)

仅保留包含在指定集合中的此集合中的元素（可选操作）。 换句话说，从该集合中删除所有未包含在指定集合中的元素。

size

int size ()

返回此集合中的元素数量。 如果此集合包含多个Integer.MAX_VALUE元素，则返回Integer.MAX_VALUE 。

spliterator

Spliterator<K> spliterator ()

在此集合中的元素上创建一个Spliterator 。 实现应记录由分割器报告的特征值。 如果分隔符报告SIZED且此集合不包含任何元素，则不需要报告此类特征值。

默认实现应该被可以返回更高效的分割器的子类覆盖。 为了保持stream()和parallelStream() }方法的预期惰性行为，分割器应该具有IMMUTABLE或CONCURRENT的特征，或者是late-binding 。 如果这些都不切实际，则重写类应描述分割器记录的绑定和结构干扰策略，并应覆盖stream()和parallelStream()方法以使用Supplier的Supplier创建流，如下所示：

Stream<E> s = StreamSupport.stream(() -> spliterator(), spliteratorCharacteristics)
 

这些要求确保由 stream()和 parallelStream()方法产生的流将反映从终端流操作开始时的集合内容。

toArray

T[] toArray (T[] a)

返回包含此集合中所有元素的数组; 返回数组的运行时类型是指定数组的运行时类型。 如果集合适合指定的数组，则将其返回。 否则，将使用指定数组的运行时类型和此集合的大小分配一个新数组。

如果此集合符合指定数组并且有空余空间（即数组的元素多于此集合），则紧跟集合结束后的数组中的元素设置为null 。 （ 只有当调用者知道这个集合不包含任何null元素时，这在确定此集合的长度时非常有用。）

如果此集合对其迭代器返回的元素的顺序做出任何保证，则此方法必须以相同顺序返回元素。

与toArray()方法一样，此方法充当基于数组和基于集合的API之间的桥梁。 此外，该方法允许精确控制输出数组的运行时类型，并且在某些情况下可以用于节省分配成本。

假设x是已知只包含字符串的集合。 以下代码可用于将集合转储到新分配的数组String中 ：

     String[] y = x.toArray(new String[0]);

toArray

Object[] toArray ()

返回包含此集合中所有元素的数组。 如果此集合对其迭代器返回的元素的顺序做出任何保证，则此方法必须以相同顺序返回元素。

返回的数组将是“安全的”，因为这个集合没有维护它的引用。 （换句话说，即使该集合由数组支持，该方法也必须分配一个新数组）。 调用者可以自由修改返回的数组。

此方法充当基于数组和基于集合的API之间的桥梁。

toString

String toString ()

返回此集合的字符串表示形式。 字符串表示形式由集合元素的字符串表示形式组成，它们按其迭代器返回的顺序包含在方括号（ "[]" ）中。 相邻元素由字符", " （逗号和空格）分隔。 元素通过valueOf(Object)转换为字符串。