Класс AbstractList<E>

modCount

protected transient int modCount

AbstractList

protected AbstractList()

add

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 - если некоторые свойства этого элемента препятствуют его добавлению в этот список

get

public abstract E get(int index)

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

set

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())

add

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())

remove

public E remove(int index)

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

indexOf

public int indexOf(Object o)

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

lastIndexOf

public int lastIndexOf(Object o)

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

clear

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 не поддерживается этим списком

addAll

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

Specified by:

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

Implementation Requirements:

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

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

Parameters:

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

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

Returns:

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

Throws:

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

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

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

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

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

iterator

public Iterator<E> iterator()

Specified by:

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

Specified by:

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

Specified by:

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

Specified by:

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

Implementation Requirements:

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

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

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

Returns:

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

listIterator

public ListIterator<E> listIterator()

Specified by:

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

Implementation Requirements:

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

Returns:

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

See Also:

• listIterator(int)

listIterator

public ListIterator<E> listIterator(int index)

Specified by:

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

Implementation Requirements:

Эта реализация возвращает простую реализацию интерфейса 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.

Parameters:

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

Returns:

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

Throws:

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

subList

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

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

Specified by:

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

Implementation Requirements:

Эта реализация возвращает список, который является подклассом AbstractList. Подкласс хранит в частных полях размер subList (который может меняться на протяжении его существования) и ожидаемое значение 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, если это не так.

Parameters:

fromIndex - нижняя граница (включая) subList

toIndex - верхняя граница (исключая) subList

Returns:

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

Throws:

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

IllegalArgumentException - если индексы конечных точек расположены в неправильном порядке (fromIndex > toIndex)

equals

public boolean equals(Object o)

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

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

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

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

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

equals в классе Object

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

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

Параметры:

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

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

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

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

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

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

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

hashCode в классе Object

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

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

Возвращает:

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

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

removeRange

protected void removeRange(int fromIndex, int toIndex)

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

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

Параметры:

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

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