Класс AbstractCollection<E>

protected AbstractCollection()

public abstract Iterator<E> iterator()

public abstract int size()

public boolean isEmpty()

Возвращает true, если эта коллекция не содержит элементов.

Это реализация возвращает size() == 0.

public boolean contains(Object o)

Возвращает true если эта коллекция содержит указанный элемент. Более формально, возвращает true тогда и только тогда, когда эта коллекция содержит по крайней мере один элемент e такой, что (o==null ? e==null : o.equals(e)).

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

public Object[] toArray()

Возвращает массив, содержащий все элементы в этой коллекции. Если эта коллекция гарантирует порядок возврата своих элементов итератором, этот метод должен вернуть элементы в том же порядке.

Возвращаемый массив будет «безопасным», поскольку к нему не сохраняются ссылки этой коллекции. (Другими словами, этот метод должен выделять новый массив, даже если эта коллекция поддерживается массивом). Вызывающая сторона, таким образом, свободна изменять возвращаемый массив.

Этот метод служит мостом между основанными на массиве и на основе коллекций API.

Эта реализация возвращает массив, содержащий все элементы, возвращенные итератором этой коллекции, в том же порядке, хранящиеся в последовательных элементах массива, начиная с индекса 0. Длина возвращаемого массива равна количеству элементов, возвращенных итератором, даже если размер этой коллекции изменяется во время итерации, как может произойти, если коллекция допускает одновременное изменение во время итерации. Метод size вызывается только как подсказка оптимизации; правильный результат возвращается даже если итератор возвращает другое количество элементов.

Этот метод эквивалентен:

List<E> list = new ArrayList<E>(size());
 for (E e : this)
     list.add(e);
 return list.toArray();

public <T> T[] toArray(T[] a)

Возвращает массив, содержащий все элементы в этой коллекции; тип выполнения возвращаемого массива — указанного массива. Если коллекция помещается в указанный массив, она возвращается в нем. В противном случае, выделяется новый массив с типом выполнения указанного массива и размером этой коллекции.

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

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

Как и метод Collection.toArray(), этот метод служит мостом между основанными на массиве и основанными на коллекции API. Кроме того, этот метод позволяет точно контролировать тип выполнения выходного массива и, при определенных обстоятельствах, может использоваться для экономии затрат на выделение памяти.

Предположим, что x — это коллекция, известная тем, что содержит только строки. Следующий код может использоваться для выгрузки коллекции в новый выделенный массив String:

String[] y = x.toArray(new String[0]);

Обратите внимание, что toArray(new Object[0]) идентичен по функции toArray().

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

Этот метод эквивалентен:

List<E> list = new ArrayList<E>(size());
 for (E e : this)
     list.add(e);
 return list.toArray(a);

public boolean add(E e)

Обеспечивает, что эта коллекция содержит указанный элемент (необязательная операция). Возвращает true если эта коллекция изменилась в результате вызова. (Возвращает false если эта коллекция не допускает дубликатов и уже содержит указанный элемент.)

Коллекции, поддерживающие эту операцию, могут накладывать ограничения на добавляемые элементы. В частности, некоторые коллекции будут отказываться добавлять null элементы, а другие наложат ограничения на тип добавляемых элементов. Классы коллекций должны четко указывать в своей документации любые ограничения на добавляемые элементы.

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

Эта реализация всегда выбрасывает UnsupportedOperationException.

public boolean remove(Object o)

Удаляет единственный экземпляр указанного элемента из этой коллекции, если он присутствует (необязательная операция). Более формально, удаляет элемент e такой, что (o==null ? e==null : o.equals(e)), если эта коллекция содержит один или несколько таких элементов. Возвращает true если эта коллекция содержала указанный элемент (или, что эквивалентно, если эта коллекция изменилась в результате вызова).

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

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

public boolean containsAll(Collection<?> c)

Возвращает true если эта коллекция содержит все элементы в указанной коллекции.

Эта реализация итерируется по указанной коллекции, проверяя каждый элемент, возвращенный итератором по очереди, чтобы увидеть, содержится ли он в этой коллекции. Если все элементы так содержатся, возвращается true, в противном случае false.

public boolean addAll(Collection<? extends E> c)

Добавляет все элементы из указанной коллекции в эту коллекцию (необязательная операция). Поведение этой операции не определено, если указанная коллекция изменяется во время выполнения операции. (Это подразумевает, что поведение этого вызова не определено, если указанная коллекция является этой коллекцией, и эта коллекция не пуста.)

Эта реализация итерируется по указанной коллекции и добавляет каждый объект, возвращаемый итератором, в эту коллекцию по очереди.

Обратите внимание, что эта реализация выбросит UnsupportedOperationException, если add не переопределён (предполагается, что указанная коллекция не пуста).

public boolean removeAll(Collection<?> c)

Удаляет все элементы этой коллекции, которые также содержатся в указанной коллекции (необязательная операция). После возврата этого вызова эта коллекция не будет содержать общих элементов с указанной коллекцией.

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

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

public boolean retainAll(Collection<?> c)

Сохраняет только элементы в этой коллекции, которые содержатся в указанной коллекции (необязательная операция). Другими словами, удаляет из этой коллекции все её элементы, которые не содержатся в указанной коллекции.

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

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

public void clear()

Удаляет все элементы из этой коллекции (необязательная операция). Коллекция будет пустой после возврата этого метода.

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

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

public String toString()