Класс AbstractList<E>

protected transient int modCount

protected AbstractList()

public boolean add(E e)

Определен в:

add в интерфейсе Collection<E>

Определен в:

add в интерфейсе List<E>

Переопределяет:

add в классе AbstractCollection<E>

Требования к реализации:

Эта реализация вызывает add(size(), e).

Обратите внимание: эта реализация выбрасывает UnsupportedOperationException, если метод add(int, E) не переопределен.

Параметры:

e — элемент, который нужно добавить в конец этого списка

Возвращает:

true (согласно спецификации Collection.add(E))

Выбрасывает:

UnsupportedOperationException — если операция add не поддерживается этим списком

ClassCastException — если класс указанного элемента не позволяет добавить его в этот список

NullPointerException — если указанный элемент равен null, а этот список не допускает элементы null

IllegalArgumentException — если какое-либо свойство этого элемента не позволяет добавить его в этот список

public abstract E get(int index)

Определен в:

get в интерфейсе List<E>

Параметры:

index — индекс возвращаемого элемента

Возвращает:

элемент, расположенный в указанной позиции этого списка

Выбрасывает:

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index >= size())

public E set(int index, E element)

Определен в:

set в интерфейсе List<E>

Требования к реализации:

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

Параметры:

index — индекс заменяемого элемента

element — элемент, который будет сохранен в указанной позиции

Возвращает:

элемент, ранее находившийся в указанной позиции

Выбрасывает:

UnsupportedOperationException — если операция set не поддерживается этим списком

ClassCastException — если класс указанного элемента не позволяет добавить его в этот список

NullPointerException — если указанный элемент равен null, а этот список не допускает элементы null

IllegalArgumentException — если какое-либо свойство указанного элемента не позволяет добавить его в этот список

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index >= size())

public void add(int index, E element)

Определен в:

add в интерфейсе List<E>

Требования к реализации:

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

Параметры:

index — позиция, в которую нужно вставить указанный элемент

element — вставляемый элемент

Выбрасывает:

UnsupportedOperationException — если операция add не поддерживается этим списком

ClassCastException — если класс указанного элемента не позволяет добавить его в этот список

NullPointerException — если указанный элемент равен null, а этот список не допускает элементы null

IllegalArgumentException — если какое-либо свойство указанного элемента не позволяет добавить его в этот список

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index > size())

public E remove(int index)

Определен в:

remove в интерфейсе List<E>

Требования к реализации:

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

Параметры:

index — индекс удаляемого элемента

Возвращает:

элемент, ранее находившийся в указанной позиции

Выбрасывает:

UnsupportedOperationException — если операция remove не поддерживается этим списком

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index >= size())

public int indexOf(Object o)

Определен в:

indexOf в интерфейсе List<E>

Требования к реализации:

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

Параметры:

o — искомый элемент

Возвращает:

индекс первого вхождения указанного элемента в этом списке или -1, если список не содержит этот элемент

Выбрасывает:

ClassCastException — если тип указанного элемента несовместим с этим списком (необязательно)

NullPointerException — если указанный элемент равен null, а этот список не допускает элементы null (необязательно)

public int lastIndexOf(Object o)

Определен в:

lastIndexOf в интерфейсе List<E>

Требования к реализации:

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

Параметры:

o — искомый элемент

Возвращает:

индекс последнего вхождения указанного элемента в этом списке или -1, если список не содержит этот элемент

Выбрасывает:

ClassCastException — если тип указанного элемента несовместим с этим списком (необязательно)

NullPointerException — если указанный элемент равен null, а этот список не допускает элементы null (необязательно)

public void clear()

Определен в:

clear в интерфейсе Collection<E>

Определен в:

clear в интерфейсе List<E>

Переопределяет:

clear в классе AbstractCollection<E>

Требования к реализации:

Эта реализация вызывает removeRange(0, size()).

Обратите внимание: эта реализация выбрасывает UnsupportedOperationException, если remove(int index) или removeRange(int fromIndex, int toIndex) не переопределен.

Выбрасывает:

UnsupportedOperationException — если операция clear не поддерживается этим списком

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

Определен в:

addAll в интерфейсе List<E>

Требования к реализации:

Эта реализация получает итератор указанной коллекции и перебирает ее, вставляя полученные из итератора элементы в этот список в соответствующую позицию по одному, используя add(int, E). Во многих реализациях этот метод переопределяется для повышения эффективности.

Обратите внимание: эта реализация выбрасывает UnsupportedOperationException, если метод add(int, E) не переопределен.

Параметры:

index — позиция для вставки первого элемента указанной коллекции

c — коллекция с элементами, которые нужно добавить в этот список

Возвращает:

true, если список изменился в результате вызова

Выбрасывает:

UnsupportedOperationException — если операция addAll не поддерживается этим списком

ClassCastException — если класс какого-либо элемента указанной коллекции не позволяет добавить его в этот список

NullPointerException — если указанная коллекция содержит один или несколько элементов null, а этот список не допускает элементы null, либо если указанная коллекция равна null

IllegalArgumentException — если какое-либо свойство элемента указанной коллекции не позволяет добавить его в этот список

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index > size())

public Iterator<E> iterator()

Определен в:

iterator в интерфейсе Collection<E>

Определен в:

iterator в интерфейсе Iterable<E>

Определен в:

iterator в интерфейсе List<E>

Определен в:

iterator в классе AbstractCollection<E>

Требования к реализации:

Эта реализация возвращает простую реализацию интерфейса итератора, использующую методы size(), get(int) и remove(int) базового списка.

Обратите внимание: итератор, возвращаемый этим методом, выбрасывает UnsupportedOperationException в ответ на вызов метода remove, если метод remove(int) списка не переопределен.

Эта реализация может выбрасывать исключения времени выполнения при одновременном изменении, как описано в спецификации поля modCount (защищенного).

Возвращает:

итератор по элементам этого списка в правильном порядке

public ListIterator<E> listIterator()

Определен в:

listIterator в интерфейсе List<E>

Требования к реализации:

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

Возвращает:

итератор списка по элементам этого списка (в правильном порядке)

См. также:

• listIterator(int)

public ListIterator<E> listIterator(int index)

Определен в:

listIterator в интерфейсе List<E>

Требования к реализации:

Эта реализация возвращает простую реализацию интерфейса ListIterator, расширяющую реализацию интерфейса Iterator, возвращаемую методом iterator(). Реализация ListIterator использует методы get(int), set(int, E), add(int, E) и remove(int) базового списка.

Обратите внимание: итератор списка, возвращаемый этой реализацией, выбрасывает UnsupportedOperationException в ответ на вызовы методов remove, set и add, если методы remove(int), set(int, E) и add(int, E) списка не переопределены.

Эта реализация может выбрасывать исключения времени выполнения при одновременном изменении, как описано в спецификации поля modCount (защищенного).

Параметры:

index — индекс первого элемента, который будет возвращен итератором списка (при вызове next)

Возвращает:

итератор списка по элементам этого списка (в правильном порядке), начиная с указанной позиции

Выбрасывает:

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (index < 0 || index > size())

public List<E> subList(int fromIndex, int toIndex)

     list.subList(from, to).clear();

Определен в:

subList в интерфейсе List<E>

Требования к реализации:

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

Методы подкласса set(int, E), get(int), add(int, E), remove(int), addAll(int, Collection) и removeRange(int, int) делегируют вызовы соответствующим методам базового абстрактного списка после проверки границ индекса и корректировки смещения. Метод addAll(Collection c) просто возвращает addAll(size, c).

Метод listIterator(int) возвращает «объект-обертку» над итератором списка базового списка, созданным соответствующим методом базового списка. Метод iterator просто возвращает listIterator(), а метод size просто возвращает поле подкласса size.

Все методы сначала проверяют, равно ли фактическое значение modCount базового списка ожидаемому, и выбрасывают ConcurrentModificationException, если это не так.

Параметры:

fromIndex — нижняя граница (включительно) подсписка

toIndex — верхняя граница (исключительно) подсписка

Возвращает:

представление указанного диапазона в этом списке

Выбрасывает:

IndexOutOfBoundsException — если индекс одной из границ находится вне допустимого диапазона (fromIndex < 0 || toIndex > size)

IllegalArgumentException — если индексы границ указаны в неправильном порядке (fromIndex > toIndex)

public boolean equals(Object o)

Определен в:

equals в интерфейсе Collection<E>

Определен в:

equals в интерфейсе List<E>

Переопределяет:

equals в классе Object

Требования к реализации:

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

Параметры:

o — объект, который нужно сравнить с этим списком на равенство

Возвращает:

true, если указанный объект равен этому списку

См. также:

• Object.equals(Object)
• Set.equals(Object)
• List.equals(Object)

public int hashCode()

Определен в:

hashCode в интерфейсе Collection<E>

Определен в:

hashCode в интерфейсе List<E>

Переопределяет:

hashCode в классе Object

Требования к реализации:

Эта реализация использует в точности тот же код, который применяется для определения функции хеширования списка в документации к методу List.hashCode().

Возвращает:

значение хеш-кода этого списка

См. также:

• Object.hashCode()
• Object.equals(Object)

protected void removeRange(int fromIndex, int toIndex)

Требования к реализации:

Эта реализация получает итератор списка, расположенный перед fromIndex, и многократно вызывает ListIterator.next, а затем ListIterator.remove, пока весь диапазон не будет удален. Примечание: если ListIterator.remove требует линейного времени, этой реализации потребуется квадратичное время.

Параметры:

fromIndex — индекс первого удаляемого элемента

toIndex — индекс, следующий за последним удаляемым элементом