源码学习之ListIterator

package java.util;

/**
 * 继承于Iterator。多了获取下一个元素的索引方法：nextIndex()；
 * 多了向前的迭代：hasPrevious(),previous(),previousIndex()。
 * 多了add、set方法
 * @since   1.2
 */
public interface ListIterator<E> extends Iterator<E> {
    // Query Operations

    /**
     * 同Iterator
     */
    boolean hasNext();

    /**
     * 同Iterator
     */
    E next();

    /**
     * 相应于hasNext()
     */
    boolean hasPrevious();

    /**
     * 相应于next()
     */
    E previous();

    /**
     * next()方法返回的元素的索引
     */
    int nextIndex();

    /**
     * 相应于nextIndex()
     */
    int previousIndex();


    // Modification Operations

    /**
     * 继承与Iterator()
     */
    void remove();

    /**
     * 需要在next()或previous()后调用，设置当前位置的元素
     * @throws UnsupportedOperationException
     * @throws ClassCastException
     * @throws IllegalArgumentException
     * @throws IllegalStateException
     */
    void set(E e);

    /**
     * 在next()元素之前插入或者在previous()元素之后插入
     * @throws UnsupportedOperationException
     * @throws ClassCastException
     * @throws IllegalArgumentException 
     */
    void add(E e);
}