Java集合系列之LinkedList源码分析

//结点内部类
private static class Node {
  E item;     //元素
  Node next;  //下一个节点
  Node prev;  //上一个节点

  Node(Node prev, E element, Node next) {
    this.item = element;
    this.next = next;
    this.prev = prev;
  }
}

//集合元素个数
transient int size = 0;

//头结点引用
transient Node first;

//尾节点引用
transient Node last;

//无参构造器
public LinkedList() {}

//传入外部集合的构造器
public LinkedList(Collection<? extends E> c) {
  this();
  addAll(c);
}

//增(添加)
public boolean add(E e) {
  //在链表尾部添加
  linkLast(e);
  return true;
}

//增(插入)
public void add(int index, E element) {
  checkPositionIndex(index);
  if (index == size) {
    //在链表尾部添加
    linkLast(element);
  } else {
    //在链表中部插入
    linkBefore(element, node(index));
  }
}

//删(给定下标)
public E remove(int index) {
  //检查下标是否合法
  checkElementIndex(index);
  return unlink(node(index));
}

//删(给定元素)
public boolean remove(Object o) {
  if (o == null) {
    for (Node x = first; x != null; x = x.next) {
      if (x.item == null) {
        unlink(x);
        return true;
      }
    }
  } else {
    //遍历链表
    for (Node x = first; x != null; x = x.next) {
      if (o.equals(x.item)) {
        //找到了就删除
        unlink(x);
        return true;
      }
    }
  }
  return false;
}

//改
public E set(int index, E element) {
  //检查下标是否合法
  checkElementIndex(index);
  //获取指定下标的结点引用
  Node x = node(index);
  //获取指定下标结点的值
  E oldVal = x.item;
  //将结点元素设置为新的值
  x.item = element;
  //返回之前的值
  return oldVal;
}

//查
public E get(int index) {
  //检查下标是否合法
  checkElementIndex(index);
  //返回指定下标的结点的值
  return node(index).item;
}

//链接到指定结点之前
void linkBefore(E e, Node succ) {
  //获取给定结点的上一个结点引用
  final Node pred = succ.prev;
  //创建新结点, 新结点的上一个结点引用指向给定结点的上一个结点
  //新结点的下一个结点的引用指向给定的结点
  final Node newNode = new Node<>(pred, e, succ);
  //将给定结点的上一个结点引用指向新结点
  succ.prev = newNode;
  //如果给定结点的上一个结点为空, 表明给定结点为头结点
  if (pred == null) {
    //将头结点引用指向新结点
    first = newNode;
  } else {
    //否则, 将给定结点的上一个结点的下一个结点引用指向新结点
    pred.next = newNode;
  }
  //集合元素个数加一
  size++;
  //修改次数加一
  modCount++;
}

//卸载指定结点
E unlink(Node x) {
  //获取给定结点的元素
  final E element = x.item;
  //获取给定结点的下一个结点的引用
  final Node next = x.next;
  //获取给定结点的上一个结点的引用
  final Node prev = x.prev;

  //如果给定结点的上一个结点为空, 说明给定结点为头结点
  if (prev == null) {
    //将头结点引用指向给定结点的下一个结点
    first = next;
  } else {
    //将上一个结点的后继结点引用指向给定结点的后继结点
    prev.next = next;
    //将给定结点的上一个结点置空
    x.prev = null;
  }

  //如果给定结点的下一个结点为空, 说明给定结点为尾结点
  if (next == null) {
    //将尾结点引用指向给定结点的上一个结点
    last = prev;
  } else {
    //将下一个结点的前继结点引用指向给定结点的前继结点
    next.prev = prev;
    x.next = null;
  }

  //将给定结点的元素置空
  x.item = null;
  //集合元素个数减一
  size--;
  //修改次数加一
  modCount++;
  return element;
}

//根据指定位置获取结点
Node node(int index) {
  //如果下标在链表前半部分, 就从头开始查起
  if (index < (size >> 1)) {
    Node x = first;
    for (int i = 0; i < index; i++) {
      x = x.next;
    }
    return x;
  } else {
    //如果下标在链表后半部分, 就从尾开始查起
    Node x = last;
    for (int i = size - 1; i > index; i--) {
      x = x.prev;
    }
    return x;
  }
}

//获取头结点
public E peek() {
  final Node f = first;
  return (f == null) ? null : f.item;
}

//获取头结点
public E element() {
  return getFirst();
}

//弹出头结点
public E poll() {
  final Node f = first;
  return (f == null) ? null : unlinkFirst(f);
}

//移除头结点
public E remove() {
  return removeFirst();
}

//在队列尾部添加结点
public boolean offer(E e) {
  return add(e);
}

//在头部添加
public boolean offerFirst(E e) {
  addFirst(e);
  return true;
}

//在尾部添加
public boolean offerLast(E e) {
  addLast(e);
  return true;
}

//获取头结点
public E peekFirst() {
  final Node f = first;
  return (f == null) ? null : f.item;
 }

//获取尾结点
public E peekLast() {
  final Node l = last;
  return (l == null) ? null : l.item;
}

//入栈
public void push(E e) {
  addFirst(e);
}

//出栈
public E pop() {
  return removeFirst();
}