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

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

liuyuhang原创，未经允许进制转载

本文举例使用的是JDK8的API

目录：一点一点看JDK源码（〇）

1.综述

　　List译为表，一览表，列表，目录，名单，有种index的意味在里头

　　编程语言中的List是强调线性，可以简单的视为一个双向串行的集合

　　List的特色是在结婚的任何位置增加或 删除元素都比较快，本身并不只是随机存取。

　　同时，List是众多语言中都提供的常用类库之一。

　　java.util.List是一个接口，该接口继承了Collection接口，因此同样方法，作为接口只是定义规范不同。

　　实际的不同要看独特的定义或独特的实现才可以。

2.关注点

　　对List的关注，更多的是倾向于其实现类的关注，不仅仅是该接口定义的规范或List本身的特性

　　而是对实现类的具体关注。

　　根据List的类注释中的@see，发现以下的关注点

• Collection（父接口）
• Set（接口）
• ArrayList（子类实现）
• LinkedList（子类实现）
• Vector（子类实现）
• Arrays#asList(Object[])（工具类转换方法）
• Collections#nCopies(int, Object)（工具类转换方法）
• Collections#EMPTY_LIST（工具类转换方法）
• AbstractList（相关抽象类）
• AbstractSequentialList（相关抽象类）

　　关联的关注点应该主要只有这些，这些都并非源码本身的部分。

　　对于Collection的剖析，请看我上一篇文章

　　一点一点看JDK源码（一）Collection体系概览

3.源码剖析

　　先上List源码，去掉原doc注释，与Collection中重复的部分不再提及，只对特有的增加注释。

public interface List<E> extends Collection<E> {

　　/**
　　* 定义addAll方法，从某个index开始插入指定集合实例
　　*/
　　boolean addAll(int index, Collection<? extends E> c);

　　/**
　　* 定义removeAll方法，从某个index开始删除指定集合实例
　　*/
　　boolean removeAll(Collection<?> c);

　　/**
　　* 定义removeAll方法，从某个index开始删除指定集合实例
　　*/
　　boolean retainAll(Collection<?> c);

　　/**
　　* jdk1.8新增
　　* 大意为：
　　* 定义replaceAll方法，根据传递参数的函数式，传递内容是接口类型
　　* 该接口定义了operator函数，该函数传递给Objects.requireNonNull进行判断
　　* 匹配成功则进行set值进行替换，使用List迭代器进行迭代替换
　　* @since 1.8
　　*/
　　default void replaceAll(UnaryOperator<E> operator) {
　　　　Objects.requireNonNull(operator);
　　　　final ListIterator<E> li = this.listIterator();
　　　　while (li.hasNext()) {
　　　　li.set(operator.apply(li.next()));
　　　　}
　　}

　　/**　　
　　* jdk1.8新增
　　* 大意为：
　　* 定义sort方法，根据传递参数的函数式，传递内容是接口类型
　　* 该接口定义了Comparator函数，该函数传递给Arrays.sort进行判断并排序

　　* 并根据排序结果，使用迭代器迭代并重新set进List
　　* @since 1.8
　　*/
　　@SuppressWarnings({"unchecked", "rawtypes"})
　　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);
　　　　}
　　}　

　　/**
　　* List要求，定义get方法，获取指定index的值
　　*/
　　E get(int index);

　　/**
　　* List要求，定义set方法，在指定index的元素设置为目标元素
　　*/
　　E set(int index, E element);

　　/**
　　* List要求，定义add方法，在指定index添加指定元素
　　*/
　　void add(int index, E element);

　　/**
　　* List要求，定义remove方法，从指定的index删除该元素并重新调整List
　　*/
　　E remove(int index);

　　/**
　　* List要求，定义indexOf方法，正序查询指定元素第一次出现的index序号
　　*/
　　int indexOf(Object o);

　　/**
　　* List要求，定义lastIndexOf方法，倒叙查询指定元素第一次出现的的index序号
　　*/
　　int lastIndexOf(Object o);

　　/**
　　* List要求，定义ListIterator迭代器方法，获取该List的迭代器
　　*/
　　ListIterator<E> listIterator();

　　/**
　　* List要求，定义ListIterator迭代器方法，获取从指定index开始的指定迭代器
　　*/
　　ListIterator<E> listIterator(int index);

　　/**
　　* List要求，定义subList方法，从起始和结束index拆分出新的list
　　*/
　　List<E> subList(int fromIndex, int toIndex);

　　/**
　　* jdk1.8新增
　　* 大意为：
　　* 根据当前的list内容进行排序，进行迭代器拆分，拆分成新的迭代器
　　* 用于多线程迭代使用
　　* @since 1.8
　　*/
　　@Override
　　default Spliterator<E> spliterator() {
　　　　return Spliterators.spliterator(this, Spliterator.ORDERED);
　　}

　　去掉了从Collection中继承的方法以后，List有一些独特的方法，不管是add，set，remove，sub等等。

　　List接口中定义的这些方法特点是直接和index相关，由于由于是有序的，所以index相当于一种搜索方式

　　因此List有对指定元素进行操作方便的特点。

下一篇更新的文章将对ArrayList，Vector，LinkedList，进行统一特点解析

完毕，以上！