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

java.lang.Object

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

Параметры типа:: K - the type of keys; V - the type of values in the backing map

Все реализуемые интерфейсы:: 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс объекта `Object` во время выполнения.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством вызова notify или прерывания, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать, пока он не будет разбужен, обычно посредством вызова notify или прерывания, либо пока не истечет заданное время.

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

parallelStream, removeIf, stream, toArray

Модификатор и тип	Метод	Описание
`default Stream<K>`	`parallelStream()`	Возвращает, возможно, параллельный `Stream` с этой коллекцией в качестве источника.
`default boolean`	`removeIf(Predicate<? super K> filter)`	Удаляет все элементы этой коллекции, удовлетворяющие заданному предикату (необязательная операция).
`default Stream<K>`	`stream()`	Возвращает последовательный `Stream` с этой коллекцией в качестве источника.
`default <T> T[]`	`toArray(IntFunction<T[]> generator)`	Возвращает массив, содержащий все элементы этой коллекции; для выделения возвращаемого массива используется предоставленная функция `generator`.

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

forEach

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer<? super K> action)`	Выполняет заданное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.

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

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

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все элементы из этого множества (необязательная операция).
`boolean`	`containsAll(Collection<?> c)`	Возвращает `true`, если это множество содержит все элементы указанной коллекции.
`boolean`	`isEmpty()`	Возвращает `true`, если это множество не содержит элементов.
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этого множества все элементы, содержащиеся в указанной коллекции (необязательная операция).
`boolean`	`retainAll(Collection<?> c)`	Оставляет в этом множестве только элементы, содержащиеся в указанной коллекции (необязательная операция).
`int`	`size()`	Возвращает количество элементов в этом множестве (его мощность).
`default Spliterator<K>`	`spliterator()`	Создает `Spliterator` по элементам этого множества.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этого множества.
`<T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы этого множества; тип возвращаемого массива во время выполнения совпадает с типом указанного массива.

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

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.