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

java.lang.Object

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

Type Parameters:: 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 как множества ключей, в котором добавления могут быть необязательно включены, сопоставляя их с общим значением. Этот класс нельзя создать напрямую. См. 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)`	Возвращает массив, содержащий все элементы этого множества; тип массива, возвращаемого в runtime, соответствует заданному массиву.
`final String`	`toString()`	Возвращает строковое представление этого множества.

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

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

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

parallelStream, removeIf, stream, toArray

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

forEach

Методы, объявленные в интерфейсе java.util.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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/ConcurrentHashMap.KeySetView.html