一點一點看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，進行統一特點解析

 

完畢，以上！