/**
   * 默認(rèn)容量的大小
   */
  private static final int DEFAULT_CAPACITY = 10;

  /**
   * 空數(shù)組常量
   */
  private static final Object[] EMPTY_ELEMENTDATA = {};

  /**
   * 默認(rèn)的空數(shù)組常量，我們將其與EMPTY_ELEMENTDATA區(qū)分開(kāi)來(lái)，
   * 以便知道添加第一個(gè)元素時(shí)需要膨脹多少
   */
  private static final Object[] DEFAULTCAPACITY_EMPTY_ELEMENTDATA = {};


  /**
   * 存放元素的數(shù)組，從這可以發(fā)現(xiàn)ArrayList的底層實(shí)現(xiàn)就是一個(gè)Object數(shù)組
   */
  transient Object[] elementData; 

  /**
   * 數(shù)組中包含元素的個(gè)數(shù)
   */
  private int size;

  /**
   *數(shù)組的最大上限，超過(guò)上限可能導(dǎo)致OutOfMemoryError錯(cuò)誤
   */
  private static final int MAX_ARRAY_SIZE = Integer.MAX_VALUE - 8;

  /**
   * 指定大小的時(shí)候，elementData就變成了我們所指定的初始化大小了
   */
  public ArrayList(int initialCapacity) {
    if (initialCapacity > 0) {
      this.elementData = new Object[initialCapacity];
    } else if (initialCapacity == 0) {
      this.elementData = EMPTY_ELEMENTDATA;
    } else {
      throw new IllegalArgumentException("Illegal Capacity: "+
                        initialCapacity);
    }
  }

  /**
   *  根據(jù)上面的屬性可知，DEFAULTCAPACITY_EMPTY_ELEMENTDATA={}，所以默認(rèn)創(chuàng)建的是  一個(gè)大小為0的空數(shù)組
   */
  public ArrayList() {
    this.elementData = DEFAULTCAPACITY_EMPTY_ELEMENTDATA;
  }

 /**
   * 在指定的位置插入指定的元素
   */
  public void add(int index, E element) {
    rangeCheckForAdd(index);

    ensureCapacityInternal(size + 1); // Increments modCount!!
    System.arraycopy(elementData, index, elementData, index + 1,
             size - index);
    elementData[index] = element;
    size++;
  }

  /**
   * 將指定的參數(shù)添加到列表的末尾,其中size是數(shù)組中包含元素的個(gè)數(shù)
   * @param e 以附加到此列表中
   */
  public boolean add(E e) {
    ensureCapacityInternal(size + 1); 
    // 數(shù)組的下標(biāo)從0開(kāi)始，所以size++保證elementData每次添加完一個(gè)元素，元素個(gè)數(shù)也隨之加1
    elementData[size++] = e;
    return true;
  }

 // 參數(shù)minCapacity 表達(dá)的意思是所需數(shù)組的最小容量，也就是size+1, 上面?zhèn)鞯闹?
  private void ensureCapacityInternal(int minCapacity) {
    ensureExplicitCapacity(calculateCapacity(elementData, minCapacity));
  }


  /**
  * 計(jì)算容量的方法，
  */
  private static int calculateCapacity(Object[] elementData, int minCapacity) {
   // 如果是一個(gè)空數(shù)組，
    if (elementData == DEFAULTCAPACITY_EMPTY_ELEMENTDATA) {
    // DEFAULT_CAPACITY從屬性可知默認(rèn)是10，minCapactity為數(shù)組的大小
    // 由此可以看出他是在添加第一個(gè)元素的時(shí)候，才創(chuàng)建了長(zhǎng)度為10的數(shù)組
      return Math.max(DEFAULT_CAPACITY, minCapacity);
    }
    return minCapacity;
  }


 private void ensureExplicitCapacity(int minCapacity) {
    modCount++;
  // 如果此時(shí)所需要的最小的長(zhǎng)度大于原數(shù)組的長(zhǎng)度，則需要進(jìn)行擴(kuò)容
    if (minCapacity - elementData.length > 0)
      grow(minCapacity);
  }
  
  /**
   * 增加容量，以確保它至少可以容納minCapacity指定的元素?cái)?shù)量。
   * @param minCapacity 表示所需要的擴(kuò)容的量
   */
  private void grow(int minCapacity) {
    int oldCapacity = elementData.length; // 原數(shù)組的長(zhǎng)度
   //原數(shù)組的長(zhǎng)度+原數(shù)組的長(zhǎng)度/2,表示擴(kuò)容了原來(lái)大小的1.5倍，newCapacity ：表示需要擴(kuò)容的量
    int newCapacity = oldCapacity + (oldCapacity >> 1);
    if (newCapacity - minCapacity < 0)
      newCapacity = minCapacity;
   // 如果需要的擴(kuò)容量大于了本類(lèi)中定義的最大擴(kuò)容限制，則擴(kuò)容到 int 類(lèi)型最大長(zhǎng)度
    if (newCapacity - MAX_ARRAY_SIZE > 0)
      newCapacity = hugeCapacity(minCapacity);
   // 調(diào)用的是數(shù)組的復(fù)制方法，實(shí)現(xiàn)擴(kuò)容
    elementData = Arrays.copyOf(elementData, newCapacity);
  }

  private static int hugeCapacity(int minCapacity) {
    if (minCapacity < 0) // overflow
      throw new OutOfMemoryError();
   // 如若需要擴(kuò)容的量大于最大限制，則擴(kuò)容量改為 int 最大限制量：2147483647,否則為本類(lèi)中所限制長(zhǎng)度：2147483647-8
    return (minCapacity > MAX_ARRAY_SIZE) ?Integer.MAX_VALUE :MAX_ARRAY_SIZE;
  }

//對(duì)象數(shù)組：ArrayList的底層數(shù)據(jù)結(jié)構(gòu)
private transient Object[] elementData;
//elementData中已存放的元素的個(gè)數(shù)，注意：不是elementData的容量
private int size;

/**
* 創(chuàng)建一個(gè)容量為initialCapacity的空的（size==0）對(duì)象數(shù)組
*/
public ArrayList(int initialCapacity) {
super();//即父類(lèi)protected AbstractList() {}
if (initialCapacity < 0)
throw new IllegalArgumentException("Illegal Capacity:" + initialCapacity);
this.elementData = new Object[initialCapacity];
}

/**
* 默認(rèn)初始化一個(gè)容量為10的對(duì)象數(shù)組
*/
public ArrayList() {
this(10);//即上邊的public ArrayList(int initialCapacity){}構(gòu)造器
}

protected AbstractList() {
}