Java ArrayList.listIterator()方法详解

文
章
目
录

在Java中，ArrayList.listIterator()方法返回一个ListIterator，用于迭代当前列表的元素。ListIterator是一种双向迭代器，具有快速失败的特性。默认情况下，由列表迭代器返回的元素按正确的顺序排列。

1.ArrayList.listIterator()方法

listIterator()方法是重载的，有两种变体：

ListIterator listIterator() – 返回一个在此列表中迭代元素的列表迭代器。
ListIterator listIterator(int index) – 返回一个在此列表中迭代元素（按正确顺序）的列表迭代器，从列表中指定位置开始。指定的索引表示初始调用next()将返回的第一个元素。初始调用previous()将返回指定索引减一的元素。

方法参数 – 要从列表迭代器返回的第一个元素的索引。

方法返回 – 一个迭代元素的列表迭代器。

方法抛出 – IndexOutOfBoundsException – 如果索引超出范围（小于0或大于列表大小）。

2.示例

以下Java程序使用通过listIterator()方法获取的列表迭代器来迭代ArrayList，并以正向和反向方向迭代列表。

ArrayList<String> alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));
 
ListIterator<String> listItr = alphabets.listIterator();
 
System.out.println("===========Forward=========");
 
while(listItr.hasNext()) {
    System.out.println(listItr.next());
}
 
System.out.println("===========Backward=========");
 
while(listItr.hasPrevious()) {
    System.out.println(listItr.previous());
}

程序输出：

===========Forward=========
A
B
C
D

===========Backward=========
D
C
B
A

3. 在迭代期间添加和删除元素

ListIterator支持在迭代列表时添加和删除元素。

listIterator.add(Element e) – 将元素立即插入到next()将返回的元素之前，或者在previous()方法将返回的元素之后。
listIterator.remove() – 从列表中移除由next()或previous()方法返回的最后一个元素。

4. ListIterator是快速失败的

ListIterator是快速失败的。这意味着如果我们在创建列表迭代器后修改了ArrayList，那么在next()或previous()方法调用时它会抛出ConcurrentModificationException异常。

ArrayList<String> alphabets = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));

ListIterator<String> listItr = alphabets.listIterator();

listItr.next();     //A
listItr.next();     //B
   
alphabets.add("E");       

System.out.println(alphabets);  //["A", "B", "C", "D", "E"]

System.out.println(listItr.next());     //Error

程序输出:

A
B
[A, B, C, D, E]
Exception in thread "main" java.util.ConcurrentModificationException
  at java.util.ArrayList$Itr.checkForComodification(ArrayList.java:901)
  at java.util.ArrayList$Itr.next(ArrayList.java:851)
  at com.howtodoinjava.example.ArrayListExample.main(ArrayListExample.java:22)

5.Iterator和ListIterator的区别

迭代器	List迭代器
可用于迭代所有集合类。	可用于仅迭代`List`已实现的类。
仅支持仅前向迭代。	支持前向和后向迭代。
仅支持读取和删除操作。	支持所有CRUD操作。
通过方法获得`iterator()`。	通过方法获得`listIterator()`。