Интерфейс Collection

Интерфейс Collection содержит набор общих методов, которые используются в большинстве коллекций. Рассмотрим основные из них.

add(Object item) – добавляет в коллекцию новый элемент. Метод возвращает true, если добавление прошло удачно и false – если нет. Если элементы коллекции каким-то образом упорядочены, новый элемент добавляется в конец коллекции.

clear() – удаляет все элементы коллекции.

contains(Object obj) – возвращает true, если объект obj содержится в коллекции и false, если нет.

isEmpty() – проверяет, пуста ли коллекция.

remove(Object obj) – удаляет из коллекции элемент obj. Возвращает false, если такого элемента в коллекции не нашлось.

size() – возвращает количество элементов коллекции.

Существуют разновидности перечисленных методов, которые в качестве параметра принимают любую другую коллекцию.

addAll(Collection coll) – добавляет все элементы другой коллекции coll в конец данной.

removeAll(Collection coll) – удаляет из коллекции все элементы, которые присутствуют также в коллекции coll.

retainAll(Collection coll) – поступает наоборот, удаляя все элементы, кроме содержащихся в coll.

toArray() – возвращает все элементы коллекции в виде массива.

Интерфейс List

Интерфейс List описывает упорядоченный список. Элементы списка пронумерованы, начиная с нуля и к конкретному элементу можно обратиться по целочисленному индексу. Интерфейс List является наследником интерфейса Collection, поэтому содержит все его методы и добавляет к ним несколько своих:

add(int index, Object item) – вставляет элемент item в позицию index, при этом список раздвигается (все элементы, начиная с позиции index, увеличивают свой индекс на 1);

get(int index) – возвращает объект, находящийся в позиции index;

indexOf(Object obj) – возвращает индекс первого появления элемента obj в списке;

lastIndexOf(Object obj) – возвращает индекс последнего появления элемента obj в списке;

set(int index, Object item) – заменяет элемент, находящийся в позиции index объектом item;

subList(int from, int to) – возвращает новый список, представляющий собой часть данного (начиная с позицииfrom до позиции to-1 включительно).

Интерфейс Set

Интерфейс Set описывает множество. Элементы множества не упорядочены, множество не может содержать двух одинаковых элементов. Интерфейс Set унаследован от интерфейса Collection, но никаких новых методов не добавляет. Изменяется только смысл метода add(Object item) – он не станет добавлять объект item, если он уже присутствует во множестве.

Интерфейс Queue

Интерфейс Queue описывает очередь. Элементы могут добавляться в очередь только с одного конца, а извлекаться с другого (аналогично очереди в магазине). Интерфейс Queue так же унаследован от интерфейса Collection. Специфические для очереди методы:

poll() – возвращает первый элемент и удаляет его из очереди.

peek() – возвращает первый элемент очереди, не удаляя его.

offer(Object obj) – добавляет в конец очереди новый элемент и возвращает true, если вставка удалась.

Методы element() и remove() работают аналогично методам poll() и peek(), но если очередь пуста, возбуждают исключение.