Класс AbstractSequentialList<E>

public abstract class AbstractSequentialList<E>
extends AbstractList<E>

Этот класс предоставляет скелетную реализацию интерфейса List для минимизации усилий, необходимых для реализации этого интерфейса, основанного на хранилище с "последовательным доступом" (например, связанный список). Для данных с произвольным доступом (например, массив) следует использовать класс AbstractList вместо этого класса.

Этот класс является противоположностью классу AbstractList в том смысле, что он реализует методы "произвольного доступа" (get(int index), set(int index, E element), add(int index, E element) и remove(int index)) на основе итератора списка, а не наоборот.

Для реализации списка программисту нужно только расширить этот класс и предоставить реализации методов listIterator и size. Для неизменяемого списка программисту нужно только реализовать методы итератора списка hasNext, next, hasPrevious, previous и index.

Для изменяемого списка программисту дополнительно необходимо реализовать метод итератора списка set. Для списка переменного размера программисту дополнительно необходимо реализовать методы итератора списка remove и add.

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

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

Конструкторы

AbstractSequentialList

protected AbstractSequentialList()

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

Методы

get

public E get(int index)

Определено в:

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

Определено в:

get в классе AbstractList<E>

Параметры:

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

Возвращает:

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

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

set

public E set(int index,
             E element)

Определено в:

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

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

set в классе AbstractList<E>

Параметры:

index - индекс элемента для замены

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

Возвращает:

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

Исключения:

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

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

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

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

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

add

public void add(int index,
                E element)

Определено в:

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

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

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

Параметры:

index - индекс, по которому должен быть вставлен указанный элемент

element - элемент, который нужно вставить

Исключения:

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

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

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

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

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())

remove

public E remove(int index)

Определено в:

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

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

remove в классе AbstractList<E>

Параметры:

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

Возвращает:

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

Исключения:

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

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= size())

addAll

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

Определено в:

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

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

addAll в классе AbstractList<E>

Параметры:

index - индекс, по которому вставляется первый элемент из указанного набора

c - набор, содержащий элементы, которые нужно добавить в этот список

Возвращает:

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

Исключения:

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

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

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

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

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())

iterator

public Iterator<E> iterator()

Определено в:

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

Определено в:

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

Определено в:

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

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

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

Возвращает:

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

listIterator

public abstract ListIterator<E> listIterator(int index)

Возвращает итератор списка по элементам в этом списке (в правильной последовательности).

Определено в:

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

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

listIterator в классе AbstractList<E>

Параметры:

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

Возвращает:

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

Исключения:

IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index > size())