一点一点看JDK源码（二）java.util.List

  1 public interface List<E> extends Collection<E> {
  2 
  3 　　/**
  4 　　* 定义addAll方法，从某个index开始插入指定集合实例
  5 　　*/
  6 　　boolean addAll(int index, Collection<? extends E> c);
  7 
  8 　　/**
  9 　　* 定义removeAll方法，从某个index开始删除指定集合实例
 10 　　*/
 11 　　boolean removeAll(Collection<?> c);
 12 
 13 　　/**
 14 　　* 定义removeAll方法，从某个index开始删除指定集合实例
 15 　　*/
 16 　　boolean retainAll(Collection<?> c);
 17 
 18 　　/**
 19 　　* jdk1.8新增
 20 　　* 大意为：
 21 　　* 定义replaceAll方法，根据传递参数的函数式，传递内容是接口类型
 22 　　* 该接口定义了operator函数，该函数传递给Objects.requireNonNull进行判断
 23 　　* 匹配成功则进行set值进行替换，使用List迭代器进行迭代替换
 24 　　* @since 1.8
 25 　　*/
 26 　　default void replaceAll(UnaryOperator<E> operator) {
 27 　　　　Objects.requireNonNull(operator);
 28 　　　　final ListIterator<E> li = this.listIterator();
 29 　　　　while (li.hasNext()) {
 30 　　　　li.set(operator.apply(li.next()));
 31 　　　　}
 32 　　}
 33 
 34 　　/**　　
 35 　　* jdk1.8新增
 36 　　* 大意为：
 37 　　* 定义sort方法，根据传递参数的函数式，传递内容是接口类型
 38 　　* 该接口定义了Comparator函数，该函数传递给Arrays.sort进行判断并排序
 39 
 40 　　* 并根据排序结果，使用迭代器迭代并从新set进List
 41 　　* @since 1.8
 42 　　*/
 43 　　@SuppressWarnings({"unchecked", "rawtypes"})
 44 　　default void sort(Comparator<? super E> c) {
 45 　　　　Object[] a = this.toArray();
 46 　　　　Arrays.sort(a, (Comparator) c);
 47 　　　　ListIterator<E> i = this.listIterator();
 48 　　　　for (Object e : a) {
 49 　　　　　　i.next();
 50 　　　　　　i.set((E) e);
 51 　　　　}
 52 　　}　
 53 
 54 　　/**
 55 　　* List要求，定义get方法，获取指定index的值
 56 　　*/
 57 　　E get(int index);
 58 
 59 　　/**
 60 　　* List要求，定义set方法，在指定index的元素设置为目标元素
 61 　　*/
 62 　　E set(int index, E element);
 63 
 64 　　/**
 65 　　* List要求，定义add方法，在指定index添加指定元素
 66 　　*/
 67 　　void add(int index, E element);
 68 
 69 　　/**
 70 　　* List要求，定义remove方法，从指定的index删除该元素并从新调整List
 71 　　*/
 72 　　E remove(int index);
 73 
 74 　　/**
 75 　　* List要求，定义indexOf方法，正序查询指定元素第一次出现的index序号
 76 　　*/
 77 　　int indexOf(Object o);
 78 
 79 　　/**
 80 　　* List要求，定义lastIndexOf方法，倒叙查询指定元素第一次出现的的index序号
 81 　　*/
 82 　　int lastIndexOf(Object o);
 83 
 84 　　/**
 85 　　* List要求，定义ListIterator迭代器方法，获取该List的迭代器
 86 　　*/
 87 　　ListIterator<E> listIterator();
 88 
 89 　　/**
 90 　　* List要求，定义ListIterator迭代器方法，获取从指定index开始的指定迭代器
 91 　　*/
 92 　　ListIterator<E> listIterator(int index);
 93 
 94 　　/**
 95 　　* List要求，定义subList方法，从起始和结束index拆分出新的list
 96 　　*/
 97 　　List<E> subList(int fromIndex, int toIndex);
 98 
 99 　　/**
100 　　* jdk1.8新增
101 　　* 大意为：
102 　　* 根据当前的list内容进行排序，进行迭代器拆分，拆分红新的迭代器
103 　　* 用于多线程迭代使用
104 　　* @since 1.8
105 　　*/
106 　　@Override
107 　　default Spliterator<E> spliterator() {
108 　　　　return Spliterators.spliterator(this, Spliterator.ORDERED);
109 　　}