//在指定位置，將指定的集合插入到當前的集合中
boolean addAll(int index, Collection<? extends E> c);

//這是一個默認實現(xiàn)的方法，會通過Iterator的方式對每個元素進行指定的操作
default void replaceAll(UnaryOperator<E> operator) {
    Objects.requireNonNull(operator);
    final ListIterator<E> li = this.listIterator();
    while (li.hasNext()) {
        li.set(operator.apply(li.next()));
    }
}

//排序，依據(jù)指定的規(guī)則對當前集合進行排序，可以看到，排序是通過Arrays這個工具類完成的。
default void sort(Comparator<? super E> c) {
    Object[] a = this.toArray();
    Arrays.sort(a, (Comparator) c);
    ListIterator<E> i = this.listIterator();
    for (Object e : a) {
        i.next();
        i.set((E) e);
    }
}

//獲取指定位置的元素
E get(int index);

//修改指定位置元素的值
E set(int index, E element);

//將指定元素添加到指定的位置
void add(int index, E element);

//將指定位置的元素移除
E remove(int index);

//返回一個元素在集合中首次出現(xiàn)的位置
int indexOf(Object o);

//返回一個元素在集合中最后一次出現(xiàn)的位置
int lastIndexOf(Object o);

//ListIterator繼承于Iterator，主要增加了向前遍歷的功能
ListIterator<E> listIterator();

//從指定位置開始，返回一個ListIterator
ListIterator<E> listIterator(int index);

//返回一個子集合[fromIndex, toIndex)，非結構性的修改返回值會反映到原表，反之亦然。
//如果原表進行了結構修改，則返回的子列表可能發(fā)生不可預料的事情
List<E> subList(int fromIndex, int toIndex);

//在AbstractCollection中，add方法默認會拋出異常，
//而在這里是調用了add(int index, E e)方法，但這個方法也是沒有實現(xiàn)的。
//這里默認會把元素添加到末尾。
public boolean add(E e) {
    add(size(), e);
    return true;
}

//同上，這個只需要進行一次遍歷即可
public boolean addAll(int index, Collection<? extends E> c) {
    //...   
}

public Iterator<E> iterator() {
    return new Itr();
}

public ListIterator<E> listIterator() {
    return listIterator(0);
}

public ListIterator<E> listIterator(final int index) {
    rangeCheckForAdd(index);
    return new ListItr(index);
}

//尋找一個元素首次出現(xiàn)的位置，只需要從前往后遍歷，找到那個元素并返回其位置即可。
public int indexOf(Object o) {
    ListIterator<E> it = listIterator();
    if (o==null) {
        while (it.hasNext())
            if (it.next()==null)
                return it.previousIndex();
    } else {
        while (it.hasNext())
            if (o.equals(it.next()))
                return it.previousIndex();
    }
    return -1;
}

//同理，尋找一個元素最后一次出現(xiàn)的位置，只需要從列表最后一位向前遍歷即可。
//看到listIterator(int index)方法是可以傳遞參數(shù)的，這個我想我們都可以照著寫出來了。
public int lastIndexOf(Object o) {
    //...
}

//這個方法是把從fromIndex到toIndex之間的元素從集合中刪除。
//clear()方法也是調用這個實現(xiàn)的（我認為clear實現(xiàn)意義并不大，因為在其上級AbstractCollection中已經有了具體實現(xiàn)）。
protected void removeRange(int fromIndex, int toIndex) {
    ListIterator<E> it = listIterator(fromIndex);
    for (int i=0, n=toIndex-fromIndex; i<n; i++) {
        it.next();
        it.remove();
    }
}

public boolean equals(Object o) {
    if (o == this)
        return true;
    if (!(o instanceof List))
        return false;

    ListIterator<E> e1 = listIterator();
    ListIterator<?> e2 = ((List<?>) o).listIterator();
    while (e1.hasNext() && e2.hasNext()) {
        E o1 = e1.next();
        Object o2 = e2.next();
        //這里用到了數(shù)據(jù)元素的equals方法
        if (!(o1==null ? o2==null : o1.equals(o2)))
            return false;
    }
    return !(e1.hasNext() || e2.hasNext());
}

public int hashCode() {
    int hashCode = 1;
    for (E e : this)
        //這里用到了數(shù)據(jù)元素的hashCode方法
        hashCode = 31*hashCode + (e==null ? 0 : e.hashCode());
    return hashCode;
}