Класс ConcurrentHashMap.KeySetView<K,V>

java.lang.Object

java.util.concurrent.ConcurrentHashMap.KeySetView<K,V>

Параметры типа:: K — тип ключей; V — тип значений в базовой карте

Все реализуемые интерфейсы:: Serializable, Iterable<K>, Collection<K>, Set<K>

Внешний класс:: ConcurrentHashMap<K,V>

public static final class ConcurrentHashMap.KeySetView<K,V> extends Object implements Set<K>, Serializable

Представление ConcurrentHashMap в виде Set ключей, в котором добавление элементов может быть разрешено путём сопоставления с общим значением. Непосредственно создать экземпляр этого класса нельзя. См. keySet(), keySet(V), newKeySet(), newKeySet(int).

Начиная с версии:

1.8

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`add(K e)`	Добавляет указанный ключ в это представление множества, сопоставляя ключу значение по умолчанию в базовой карте, если оно задано.
`boolean`	`addAll(Collection<? extends K> c)`	Добавляет все элементы указанной коллекции в это множество, как если бы для каждого из них вызывался метод `add(K)`.
`final void`	`clear()`	Удаляет все элементы из этого представления, удаляя все отображения из карты, на основе которой оно создано.
`boolean`	`contains(Object o)`	Возвращает `true`, если эта коллекция содержит указанный элемент.
`final boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если эта коллекция содержит все элементы указанной коллекции.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой коллекцией на равенство.
`ConcurrentHashMap<K,V>`	`getMap()`	Возвращает карту, на основе которой создано это представление.
`V`	`getMappedValue()`	Возвращает значение по умолчанию, используемое при добавлении элементов, или `null`, если добавление элементов не поддерживается.
`int`	`hashCode()`	Возвращает значение хеш-кода этой коллекции.
`final boolean`	`isEmpty()`	Возвращает `true`, если эта коллекция не содержит элементов.
`Iterator<K>`	`iterator()`	Возвращает итератор по элементам этой коллекции.
`boolean`	`remove(Object o)`	Удаляет ключ из этого представления карты, удаляя ключ (и соответствующее ему значение) из базовой карты.
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этой коллекции все элементы, которые также содержатся в указанной коллекции (необязательная операция).
`final boolean`	`retainAll(Collection<?> c)`	Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции (необязательная операция).
`final int`	`size()`	Возвращает количество элементов в этой коллекции.
`final Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этой коллекции.
`final <T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения соответствует типу указанного массива.
`final String`	`toString()`	Возвращает строковое представление этой коллекции.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе Collection

parallelStream, removeIf, stream, toArray

Методы, объявленные в интерфейсе Iterable

forEach

Методы, объявленные в интерфейсе Set

clear, containsAll, isEmpty, removeAll, retainAll, size, spliterator, toArray, toArray

Подробное описание методов

getMappedValue

public V getMappedValue()

Возвращает значение по умолчанию, используемое при добавлении элементов, или null, если добавление элементов не поддерживается.

Возвращает:: значение по умолчанию, используемое при добавлении элементов, или null, если операция не поддерживается

contains

public boolean contains(Object o)

Возвращает true, если эта коллекция содержит указанный элемент. Формально метод возвращает true тогда и только тогда, когда эта коллекция содержит по крайней мере один элемент e, для которого выполняется условие Objects.equals(o, e).

Определено в:: contains в интерфейсе Collection<K>
Определено в:: contains в интерфейсе Set<K>
Параметры:: o — элемент, наличие которого в этой коллекции проверяется
Возвращает:: true, если эта коллекция содержит указанный элемент
Исключения:: NullPointerException — если указанный ключ равен null

remove

public boolean remove(Object o)

Удаляет ключ из этого представления карты, удаляя ключ (и соответствующее ему значение) из базовой карты. Если ключ отсутствует в карте, этот метод ничего не делает.

Определено в:: remove в интерфейсе Collection<K>
Определено в:: remove в интерфейсе Set<K>
Параметры:: o — ключ, который необходимо удалить из базовой карты
Возвращает:: true, если базовая карта содержала указанный ключ
Исключения:: NullPointerException — если указанный ключ равен null

iterator

public Iterator<K> iterator()

Возвращает итератор по элементам этой коллекции.

Возвращаемый итератор является слабо согласованным.

Определено в:: iterator в интерфейсе Collection<K>
Определено в:: iterator в интерфейсе Iterable<K>
Определено в:: iterator в интерфейсе Set<K>
Возвращает:: итератор по ключам базовой карты

add

public boolean add(K e)

Добавляет указанный ключ в это представление множества, сопоставляя ключу значение по умолчанию в базовой карте, если оно задано.

Определено в:: add в интерфейсе Collection<K>
Определено в:: add в интерфейсе Set<K>
Параметры:: e — добавляемый ключ
Возвращает:: true, если в результате вызова это множество изменилось
Исключения:: NullPointerException — если указанный ключ равен null; UnsupportedOperationException — если значение по умолчанию для добавления элементов не задано

addAll

public boolean addAll(Collection<? extends K> c)

Добавляет все элементы указанной коллекции в это множество, как если бы для каждого из них вызывался метод add(K).

Определено в:

addAll в интерфейсе Collection<K>

Определено в:

addAll в интерфейсе Set<K>

Параметры:

c — элементы, которые необходимо добавить в это множество

Возвращает:

true, если в результате вызова это множество изменилось

Исключения:

NullPointerException — если коллекция или любой из её элементов равны null

UnsupportedOperationException — если значение по умолчанию для добавления элементов не задано

См. также:

hashCode

public int hashCode()

Описание скопировано из интерфейса: Collection

Возвращает значение хеш-кода этой коллекции. Хотя интерфейс Collection не добавляет никаких требований к общему контракту метода Object.hashCode, программистам следует учитывать, что любой класс, переопределяющий метод Object.equals, должен также переопределить метод Object.hashCode, чтобы соблюдать общий контракт метода Object.hashCode. В частности, из c1.equals(c2) следует, что c1.hashCode()==c2.hashCode().

Определено в:

hashCode в интерфейсе Collection<K>

Определено в:

hashCode в интерфейсе Set<K>

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этой коллекции

См. также:

equals

public boolean equals(Object o)

Описание скопировано из интерфейса: Collection

Сравнивает указанный объект с этой коллекцией на равенство.

Хотя интерфейс Collection не добавляет никаких требований к общему контракту метода Object.equals, программисты, реализующие интерфейс Collection «напрямую» (то есть создающие класс, который является Collection, но не является Set или List), должны проявлять осторожность, если решат переопределить метод Object.equals. Делать это необязательно, и самый простой вариант — полагаться на реализацию Object, однако разработчик может предпочесть реализовать «сравнение значений» вместо стандартного «сравнения ссылок». (Интерфейсы List и Set требуют такого сравнения значений.)

Общий контракт метода Object.equals требует, чтобы equals был симметричным (то есть a.equals(b) тогда и только тогда, когда b.equals(a)). Контракты List.equals и Set.equals устанавливают, что списки равны только другим спискам, а множества — только другим множествам. Поэтому пользовательский метод equals для класса коллекции, не реализующего ни интерфейс List, ни интерфейс Set, должен возвращать false при сравнении этой коллекции с любым списком или множеством. (По той же логике невозможно создать класс, корректно реализующий одновременно интерфейсы Set и List.)

Определено в:

equals в интерфейсе Collection<K>

Определено в:

equals в интерфейсе Set<K>

Переопределяет:

equals в классе Object

Параметры:

o — объект, который сравнивается на равенство с этой коллекцией

Возвращает:

true, если указанный объект равен этой коллекции

См. также:

getMap

public ConcurrentHashMap<K,V> getMap()

Возвращает карту, на основе которой создано это представление.

Возвращает:: карту, на основе которой создано это представление

clear

public final void clear()

Удаляет все элементы из этого представления, удаляя все отображения из карты, на основе которой оно создано.

Определено в:: clear в интерфейсе Collection<K>

size

public final int size()

Описание скопировано из интерфейса: Collection

Возвращает количество элементов в этой коллекции. Если эта коллекция содержит более Integer.MAX_VALUE элементов, возвращает Integer.MAX_VALUE.

Определено в:: size в интерфейсе Collection<K>
Возвращает:: количество элементов в этой коллекции

isEmpty

public final boolean isEmpty()

Описание скопировано из интерфейса: Collection

Возвращает true, если эта коллекция не содержит элементов.

Определено в:: isEmpty в интерфейсе Collection<K>
Возвращает:: true, если эта коллекция не содержит элементов

toArray

public final Object[] toArray()

Описание скопировано из интерфейса: Collection

Возвращает массив, содержащий все элементы этой коллекции. Если коллекция гарантирует определённый порядок возврата элементов итератором, этот метод должен возвращать элементы в том же порядке. Тип компонента во время выполнения возвращаемого массива — Object.

Возвращаемый массив является «безопасным»: эта коллекция не хранит ссылок на него. (Иными словами, метод должен выделять новый массив, даже если эта коллекция основана на массиве.) Поэтому вызывающий код может свободно изменять возвращаемый массив.

Определено в:: toArray в интерфейсе Collection<K>
Возвращает:: массив, тип компонента во время выполнения которого — Object, содержащий все элементы этой коллекции

toArray

public final <T> T[] toArray(T[] a)

Описание скопировано из интерфейса: Collection

Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения соответствует типу указанного массива. Если коллекция помещается в указанный массив, она возвращается в нём. В противном случае выделяется новый массив с типом указанного массива во время выполнения и размером этой коллекции.

Если коллекция помещается в указанный массив с запасом (то есть массив содержит больше элементов, чем эта коллекция), элемент массива, следующий сразу за последним элементом коллекции, устанавливается в null. (Это позволяет определить размер коллекции только в том случае, если вызывающий код знает, что коллекция не содержит элементов null.)

Если коллекция гарантирует определённый порядок возврата элементов итератором, этот метод должен возвращать элементы в том же порядке.

Определено в:: toArray в интерфейсе Collection<K>
Параметры типа:: T — тип компонентов массива, в котором будет храниться коллекция
Параметры:: a — массив, в котором должны храниться элементы этой коллекции, если он достаточно велик; в противном случае для этой цели выделяется новый массив того же типа во время выполнения.
Возвращает:: массив, содержащий все элементы этой коллекции

toString

public final String toString()

Возвращает строковое представление этой коллекции. Строковое представление состоит из строковых представлений элементов коллекции в порядке, в котором их возвращает итератор, заключённых в квадратные скобки ("[]"). Соседние элементы разделяются символами ", " (запятая и пробел). Элементы преобразуются в строки, как при вызове метода String.valueOf(Object).

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этой коллекции

containsAll

public final boolean containsAll(Collection<?> c)

Описание скопировано из интерфейса: Collection

Возвращает true, если эта коллекция содержит все элементы указанной коллекции.

Определено в:

containsAll в интерфейсе Collection<K>

Параметры:

c — коллекция, наличие элементов которой в этой коллекции проверяется

Возвращает:

true, если эта коллекция содержит все элементы указанной коллекции

См. также:

removeAll

public boolean removeAll(Collection<?> c)

Описание скопировано из интерфейса: Collection

Удаляет из этой коллекции все элементы, которые также содержатся в указанной коллекции (необязательная операция). После возврата этого вызова эта коллекция не будет содержать общих элементов с указанной коллекцией.

Определено в:

removeAll в интерфейсе Collection<K>

Параметры:

c — коллекция, содержащая элементы, которые необходимо удалить из этой коллекции

Возвращает:

true, если в результате вызова эта коллекция изменилась

См. также:

retainAll

public final boolean retainAll(Collection<?> c)

Описание скопировано из интерфейса: Collection

Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции (необязательная операция). Иными словами, удаляет из этой коллекции все элементы, не содержащиеся в указанной коллекции.

Определено в:

retainAll в интерфейсе Collection<K>

Параметры:

c — коллекция, содержащая элементы, которые необходимо оставить в этой коллекции

Возвращает:

true, если в результате вызова эта коллекция изменилась

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/ConcurrentHashMap.KeySetView.html