Iterator和ListIterator关系

相同点

都是迭代器,当需要对集合中元素进行遍历不需要干涉其遍历过程时,这两种迭代器都可以使用。

不同点

功能 Iterator ListIterator
使用范围 可以应用于所有的集合(Set、List 和 Map 及其子类型) 只能用于 List 及其子类型
add 方法 不支持 有 add 方法,可以向 List 中添加对象
遍历方向 只支持 hasNext() 和 next(),顺序向后遍历 支持 hasNext()、next()、hasPrevious()、previous(),可双向遍历
索引定位 没有此功能 可以定位当前索引位置,nextIndex() 和 previousIndex()
修改操作 仅能遍历,不能修改 支持删除和修改操作,set() 方法可实现

方法详细信息

hasNext

方法签名: boolean hasNext()

以正向遍历列表时,如果列表迭代器有多个元素,则返回 true(换句话说,如果 next 返回一个元素而不是抛出异常,则返回 true)。

返回值: 如果以正向遍历列表,列表迭代器有多个元素,则返回 true。

next

方法签名: E next()

返回列表中的下一个元素。可以重复调用此方法来迭代此列表,或混合调用 previous 来前后移动(注意交替调用 next 和 previous 将重复返回相同的元素)。

返回值: 列表中的下一个元素。

抛出异常: NoSuchElementException - 如果没有可迭代的下一个元素。

hasPrevious

方法签名: boolean hasPrevious()

如果以逆向遍历列表,列表迭代器有多个元素,则返回 true。(换句话说,如果 previous 返回一个元素而不是抛出异常,则返回 true)。

返回值: 如果以逆向遍历列表,列表迭代器有多个元素,则返回 true。

previous

方法签名: E previous()

返回列表中的前一个元素。可以重复调用此方法来迭代列表,或混合调用 next 来前后移动(注意交替调用 next 和 previous 将重复返回相同的元素)。

返回值: 列表中的上一个元素。

抛出异常: NoSuchElementException - 如果没有可迭代的上一个元素。

nextIndex

方法签名: int nextIndex()

返回对 next 的后续调用所返回元素的索引。(如果列表迭代器在列表的结尾,则返回列表的大小)。

返回值: 对 next 的后续调用所返回元素的索引,如果列表迭代器在列表的结尾,则返回列表大小。

previousIndex

方法签名: int previousIndex()

返回对 previous 的后续调用所返回元素的索引。(如果列表迭代器在列表的开始,则返回 -1)。

返回值: 对 previous 的后续调用所返回元素的索引,如果列表迭代器在列表的开始,则返回 -1。

remove

方法签名: void remove()

从列表中移除由 next 或 previous 返回的最后一个元素(可选操作)。对于每个 next 或 previous 调用,只能执行一次此调用。只有在最后一次调用 next 或 previous 之后,尚未调用 ListIterator.add 时才可以执行该调用。

抛出异常:

  • UnsupportedOperationException - 如果列表迭代器不支持 remove 操作。
  • IllegalStateException - 既没有调用 next 也没有调用 previous,或者在最后一次调用 next 或 previous 后调用了 remove 或 add。

set

方法签名: void set(E e)

用指定元素替换 next 或 previous 返回的最后一个元素(可选操作)。只有在最后一次调用 next 或 previous 后既没有调用 ListIterator.remove 也没有调用 ListIterator.add 时才可以进行该调用。

参数: e - 用于替换 next 或 previous 返回的最后一个元素的元素。

抛出异常:

  • UnsupportedOperationException - 如果列表迭代器不支持 set 操作。
  • ClassCastException - 如果指定元素的类不允许该元素添加到此列表。
  • IllegalArgumentException - 如果指定元素的某个方面不允许该元素添加到此列表。
  • IllegalStateException - 如果既没有调用 next 也没有调用 previous,或者在最后一次调用 next 或 previous 后调用了 remove 或 add。

add

方法签名: void add(E e)

将指定的元素插入列表(可选操作)。该元素直接插入到 next 返回的下一个元素的前面(如果有),或者 previous 返回的下一个元素之后(如果有);如果列表没有元素,那么新元素就成为列表中的唯一元素。新元素被插入到隐式光标前:不影响对 next 的后续调用,并且对 previous 的后续调用会返回此新元素(此调用把调用 nextIndex 或 previousIndex 所返回的值增加 1)。

参数: e - 要插入的元素。

抛出异常:

  • UnsupportedOperationException - 如果列表迭代器不支持 add 操作。
  • ClassCastException - 如果指定元素的类不允许该元素添加到此列表。
  • IllegalArgumentException - 如果此元素的某个方面不允许该元素添加到此列表。