Spec-Zone.ru › OpenJDK 21

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

java.lang.Object
java.util.concurrent.ConcurrentHashMap.KeySetView<K,V>
Type Parameters:
K - тип ключей
V - тип значений в базовом отображении
All Implemented Interfaces:
Serializable, Iterable<K>, Collection<K>, Set<K>
Enclosing class:
ConcurrentHashMap<K,V>
public static final class ConcurrentHashMap.KeySetView<K,V> extends Object implements Set<K>, Serializable
Представление ConcurrentHashMap как множества ключей, в котором добавления могут быть необязательно включены, сопоставляя ключи с общим значением. Данный класс не может быть напрямую инстанцирован. См. keySet(), keySet(V), newKeySet(), newKeySet(int).
Since:
1.8
See Also:
  • Сериализованная форма

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

Модификатор и тип Метод Описание
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()
Возвращает строковое представление этой коллекции.

Методы, объявленные в классе 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 - если не было предоставлено значение по умолчанию для добавлений
См. также:
  • Set.add(Object)

hashCode

public int hashCode()
Описание скопировано из класса: Object
Возвращает значение хэш-кода для объекта. Этот метод поддерживается для использования в хэш-таблицах, таких как те, что предоставляются HashMap.

Общий контракт hashCode:

  • Всякий раз, когда он вызывается на одном и том же объекте более одного раза во время выполнения Java-приложения, метод hashCode должен последовательно возвращать одно и то же целое число, при условии, что никакая информация, используемая в equals сравнениях на объекте, не изменяется. Это целое число не обязательно должно оставаться неизменным от одного выполнения приложения к другому.
  • Если два объекта равны согласно методу equals, то вызов метода hashCode для каждого из этих двух объектов должен возвращать одинаковый результат.
  • Не требуется, чтобы, если два объекта не равны согласно методу equals, то вызов метода hashCode для каждого из этих двух объектов должен возвращать различные целые значения. Однако разработчик должен понимать, что получение различных целых значений для неравных объектов может улучшить производительность хэш-таблиц.
Определено в:
hashCode в интерфейсе Collection<K>
Определено в:
hashCode в интерфейсе Set<K>
Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого объекта.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object o)
Описание скопировано из класса: Object
Указывает, является ли какой-либо другой объект "равным" этому.

Метод equals реализует отношение эквивалентности на ссылках на объекты, отличных от null:

  • Он является рефлексивным: для любой ссылки на объект, отличной от null, x, x.equals(x) должен возвращать true.
  • Он является симметричным: для любых ссылок на объекты, отличных от null, x и y, x.equals(y) должен возвращать true тогда и только тогда, когда y.equals(x) возвращает true.
  • Он является транзитивным: для любых ссылок на объекты, отличных от null, x, y, и z, если x.equals(y) возвращает true и y.equals(z) возвращает true, то x.equals(z) должен возвращать true.
  • Он является последовательным: для любых ссылок на объекты, отличных от null, x и y, многократные вызовы x.equals(y) последовательно возвращают true или последовательно возвращают false, при условии, что никакая информация, используемая в equals сравнениях на объектах, не изменяется.
  • Для любой ссылки на объект, отличной от null, x, x.equals(null) должно возвращать false.

Отношение эквивалентности разбивает элементы, на которые она действует, на классы эквивалентности; все члены класса эквивалентности равны друг другу. Члены класса эквивалентности заменяемы друг другом, по крайней мере для некоторых целей.

Определено в:
equals в интерфейсе Collection<K>
Определено в:
equals в интерфейсе Set<K>
Переопределяет:
equals в классе Object
Параметры:
o - объект-ссылка для сравнения.
Возвращает:
true если этот объект такой же, как аргумент obj; false в противном случае.
См. также:
  • Object.hashCode()
  • HashMap

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 , если этот набор содержит все элементы в указанном наборе
См. также:
  • Collection.contains(Object)

removeAll

public boolean removeAll(Collection<?> c)
Описание скопировано из интерфейса: Collection
Удаляет все элементы этого набора, которые также содержатся в указанном наборе (необязательная операция). После возврата этого вызова этот набор не будет содержать общих элементов с указанным набором.
Указано в:
removeAll в интерфейсе Collection<K>
Параметры:
c - набор, содержащий элементы, которые нужно удалить из этого набора
Возвращает:
true , если этот набор изменился в результате вызова
См. также:
  • Collection.remove(Object)
  • Collection.contains(Object)

retainAll

public final boolean retainAll(Collection<?> c)
Описание скопировано из интерфейса: Collection
Оставляет только элементы в этом наборе, которые содержатся в указанном наборе (необязательная операция). Другими словами, удаляет из этого набора все его элементы, которые не содержатся в указанном наборе.
Указано в:
retainAll в интерфейсе Collection<K>
Параметры:
c - набор, содержащий элементы, которые необходимо сохранить в этом наборе
Возвращает:
true , если этот набор изменился в результате вызова
См. также:
  • Collection.remove(Object)
  • Collection.contains(Object)

© 1993, 2023, 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/21/docs/api/java.base/java/util/concurrent/ConcurrentHashMap.KeySetView.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API