鸿蒙OS AbstractSequentialList

AbstractSequentialList

java.lang.Object

|---java.util.AbstractCollection<E&

|---|---java.util.AbstractList<E&

|---|---|---java.util.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 方法。对于可变大小的列表，程序员应该另外实现列表迭代器的删除和添加方法。

根据 Collection 接口规范中的建议，程序员通常应该提供一个 void（无参数）和集合构造函数。

此类是 Java 集合框架的成员。

字段摘要

构造函数摘要

方法总结

构造函数详细信息

AbstractSequentialList

protected AbstractSequentialList()

唯一的构造函数。 （用于子类构造函数的调用，通常是隐式的。）

方法详情

get

public E get(int index)

返回此列表中指定位置的元素。

此实现首先获取一个指向索引元素的列表迭代器（使用 listIterator(index)）。 然后，它使用 ListIterator.next 获取元素并返回它。

指定者：

进入接口 ListE

指定者：

进入类 AbstractListE

参数：

返回:

此列表中指定位置的元素

Throws:

set

public E set(int index, E element)

将此列表中指定位置的元素替换为指定元素（可选操作）。

此实现首先获取一个指向索引元素的列表迭代器（使用 listIterator(index)）。 然后，它使用 ListIterator.next 获取当前元素并将其替换为 ListIterator.set。

请注意，如果列表迭代器未实现 set 操作，此实现将抛出 UnsupportedOperationException。

指定者：

在接口 ListE 中设置

覆盖：

在类 AbstractListE 中设置

参数：

返回:

先前在指定位置的元素

Throws:

add

public void add(int index, E element)

在此列表中的指定位置插入指定元素（可选操作）。 将当前位于该位置的元素（如果有）和任何后续元素向右移动（将其索引加一）。

此实现首先获取一个指向索引元素的列表迭代器（使用 listIterator(index)）。 然后，它使用 ListIterator.add 插入指定的元素。

请注意，如果列表迭代器未实现添加操作，此实现将抛出 UnsupportedOperationException。

指定者：

添加接口ListE

覆盖：

添加类 AbstractListE

参数：

Throws:

remove

public E remove(int index)

移除此列表中指定位置的元素（可选操作）。 将任何后续元素向左移动（从它们的索引中减去 1）。 返回从列表中删除的元素。

此实现首先获取一个指向索引元素的列表迭代器（使用 listIterator(index)）。 然后，它使用 ListIterator.remove 删除元素。

请注意，如果列表迭代器未实现删除操作，此实现将抛出 UnsupportedOperationException。

指定者：

在接口 ListE 中删除

覆盖：

在类 AbstractListE 中删除

参数：

返回:

先前在指定位置的元素

Throws:

addAll

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

将指定集合中的所有元素插入到此列表中的指定位置（可选操作）。将当前位于该位置的元素（如果有）和任何后续元素向右移动（增加它们的索引）。新元素将按照指定集合的迭代器返回的顺序出现在此列表中。如果在操作正在进行时修改了指定的集合，则此操作的行为是未定义的。 （请注意，如果指定的集合是这个列表，并且它是非空的，则会发生这种情况。）

此实现获取指定集合的迭代器和指向索引元素的列表迭代器（使用 listIterator(index)）。然后，它迭代指定的集合，将从迭代器获得的元素插入到这个列表中，一次一个，使用 ListIterator.add 后跟 ListIterator.next（跳过添加的元素）。

请注意，如果 listIterator 方法返回的列表迭代器未实现添加操作，则此实现将抛出 UnsupportedOperationException。

指定者：

接口 ListE 中的 addAll

覆盖：

类 AbstractListE 中的 addAll

参数：

返回:

如果此列表因调用而更改，则为 true

Throws:

iterator

public IteratorE iterator()

返回此列表中元素的迭代器（以正确的顺序）。

此实现仅返回列表上的列表迭代器。

指定者：

接口 CollectionE 中的迭代器

指定者：

接口 IterableE 中的迭代器

指定者：

接口 ListE 中的迭代器

覆盖：

AbstractListE 类中的迭代器

返回:

此列表中元素的迭代器（按正确顺序）

listIterator

public abstract ListIteratorE listIterator(int index)

返回此列表中元素的列表迭代器（以正确的顺序）。

指定者：

接口 ListE 中的 listIterator

覆盖：

AbstractListE 类中的 listIterator

参数：

返回:

此列表中元素的列表迭代器（按正确顺序）

Throws: