Spec-Zone.ru › OpenJDK 21

Класс AbstractSet<E>

java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractSet<E>
Параметры типа:
E - тип элементов, поддерживаемых этим множеством
Все реализованные интерфейсы:
Iterable<E>, Collection<E>, Set<E>
Прямые известные подклассы:
ConcurrentSkipListSet, CopyOnWriteArraySet, EnumSet, HashSet, TreeSet
public abstract class AbstractSet<E> extends AbstractCollection<E> implements Set<E>
Этот класс предоставляет скелетную реализацию интерфейса Set для минимизации усилий, необходимых для реализации этого интерфейса.

Процесс реализации множества, расширяя этот класс, идентичен процессу реализации коллекции, расширяя AbstractCollection, за исключением того, что все методы и конструкторы в подклассах этого класса должны подчиняться дополнительным ограничениям, накладываемым интерфейсом Set (например, метод add не должен допускать добавления нескольких экземпляров объекта в множество).

Обратите внимание, что этот класс не переопределяет никакие реализации из класса AbstractCollection. Он просто добавляет реализации для equals и hashCode.

Этот класс является членом Java Collections Framework.

С тех пор:
1.2
См. также:
  • Collection
  • AbstractCollection
  • Set

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

AbstractSet()
Модификатор Конструктор Описание
protected
Единственный конструктор.

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

Модификатор и тип Метод Описание
boolean equals(Object o)
Сравнивает указанный объект с этим множеством на равенство.
int hashCode()
Возвращает значение хэш-кода для этого множества.
boolean removeAll(Collection<?> c)
Удаляет из этого множества все его элементы, содержащиеся в указанной коллекции (необязательная операция).

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

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, toArray, toArray, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

parallelStream, removeIf, stream, toArray

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

forEach

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

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, size, spliterator, toArray, toArray

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

AbstractSet

protected AbstractSet()
Единственный конструктор. (Для вызова подклассами конструкторов, обычно неявный.)

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

equals

public boolean equals(Object o)
Сравнивает указанный объект с этим множеством на равенство. Возвращает true, если указанный объект также является множеством, оба множества имеют одинаковый размер и каждый элемент указанного множества содержится в этом множестве. Это гарантирует, что метод equals работает корректно для разных реализаций интерфейса Set.

Эта реализация сначала проверяет, является ли указанный объект этим множеством; если да, то возвращает true. Затем проверяет, является ли указанный объект множеством, размер которого совпадает с размером этого множества; если нет, то возвращает false. В противном случае возвращает containsAll((Collection) o).

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

hashCode

public int hashCode()
Возвращает значение хэш-кода для этого множества. Хэш-код множества определяется как сумма хэш-кодов элементов в множестве, где хэш-код элемента null равен нулю. Это гарантирует, что s1.equals(s2) подразумевает, что s1.hashCode()==s2.hashCode() для любых двух множеств s1 и s2, как требуется общим контрактом Object.hashCode().

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

Определяется:
hashCode в интерфейсе Collection<E>
Определяется:
hashCode в интерфейсе Set<E>
Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого множества
См. также:
  • Object.equals(Object)
  • Set.equals(Object)

removeAll

public boolean removeAll(Collection<?> c)
Удаляет из этого множества все его элементы, содержащиеся в указанной коллекции (необязательная операция). Если указанная коллекция также является множеством, эта операция эффективно модифицирует это множество так, что его значение является асимметрической разностью двух множеств.

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

Обратите внимание, что эта реализация выбросит UnsupportedOperationException, если итератор, возвращенный методом iterator, не реализует метод remove.

Определяется:
removeAll в интерфейсе Collection<E>
Определяется:
removeAll в интерфейсе Set<E>
Переопределяет:
removeAll в классе AbstractCollection<E>
Параметры:
c - коллекция, содержащая элементы, которые нужно удалить из этого множества
Возвращает:
true если это множество изменилось в результате вызова
Исключения:
UnsupportedOperationException - если операция removeAll не поддерживается этим множеством
ClassCastException - если класс элемента этого множества несовместим с указанной коллекцией (необязательно)
NullPointerException - если это множество содержит нулевой элемент, а указанная коллекция не допускает нулевых элементов (необязательно), или если указанная коллекция равна null
См. также:
  • AbstractCollection.remove(Object)
  • AbstractCollection.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/AbstractSet.html

Spec-Zone.ru

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