Spec-Zone.ru › OpenJDK 17

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

java.lang.Object
java.util.concurrent.ConcurrentHashMap.KeySetView<K,V>
Все реализованные интерфейсы:
Serializable, Iterable<K>, Collection<K>, Set<K>
Вложенный класс:
ConcurrentHashMap<K,V>
public static 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()
Возвращает строковое представление этой коллекции.

Методы, объявленные в классе 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, 2021, 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/17/docs/api/java.base/java/util/concurrent/ConcurrentHashMap.KeySetView.html

Spec-Zone.ru

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