集合之ArrayList的介绍和常用方法

package com.itheima.demo01.List;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

/*

java.util.List 接口 extends Collection 接口
List 接口的特点:
    1. 有序的集合, 存储元素和取出元素的顺序是一致的 (存储 123 取出 123)
    2. 有索引, 包含了一些带索引的方法
    3. 允许存储重复的元素

List 接口中带索引的方法 (特有)
    - public void add(int index, E element): 将指定的元素，添加到该集合中的指定位置上。- public E get(int index): 返回集合中指定位置的元素。- public E remove(int index): 移除列表中指定位置的元素, 返回的是被移除的元素。- public E set(int index, E element): 用指定元素替换集合中指定位置的元素, 返回值的更新前的元素。注意:
    操作索引的时候, 一定要防止索引越界异常
    IndexOutOfBoundsException: 索引越界异常, 集合会报
    ArrayIndexOutOfBoundsException: 数组索引越界异常
    StringIndexOutOfBoundsException: 字符串索引越界异常 

*/
public class Demo01List {

public static void main(String[] args) {
    // 创建一个 List 集合对象, 多态
    List<String> list = new ArrayList<>();
    // 使用 add 方法往集合中添加元素
    list.add("a");
    list.add("b");
    list.add("c");
    list.add("d");
    list.add("a");
    // 打印集合
    System.out.println(list);//[a, b, c, d, a]  不是地址重写了 toString

    //public void add(int index, E element): 将指定的元素，添加到该集合中的指定位置上。// 在 c 和 d 之间添加一个 itheima
    list.add(3,"itheima");//[a, b, c, itheima, d, a]
    System.out.println(list);

    //public E remove(int index): 移除列表中指定位置的元素, 返回的是被移除的元素。// 移除元素
    String removeE = list.remove(2);
    System.out.println("被移除的元素:"+removeE);// 被移除的元素:c
    System.out.println(list);//[a, b, itheima, d, a]

    //public E set(int index, E element): 用指定元素替换集合中指定位置的元素, 返回值的更新前的元素。// 把最后一个 a, 替换为 A
    String setE = list.set(4, "A");
    System.out.println("被替换的元素:"+setE);// 被替换的元素:a
    System.out.println(list);//[a, b, itheima, d, A]

    //List 集合遍历有 3 种方式
    // 使用普通的 for 循环
    for(int i=0; i<list.size(); i++){//public E get(int index): 返回集合中指定位置的元素。String s = list.get(i);
        System.out.println(s);
    }
    System.out.println("-----------------");
    // 使用迭代器
    Iterator<String> it = list.iterator();
    while(it.hasNext()){String s = it.next();
        System.out.println(s);
    }
    System.out.println("-----------------");
    // 使用增强 for
    for (String s : list) {System.out.println(s);
    }

    String r = list.get(5);//IndexOutOfBoundsException: Index 5 out-of-bounds for length 5
    System.out.println(r);

}

/*
ArrayList
ArrayList()

      构造一个初始容量为 10 的空列表。

ArrayList(Collection<? extends E> c)

      构造一个包含指定 collection 的元素的列表，这些元素是按照该 collection 的迭代器返回它们的顺序排列的。

ArrayList(int initialCapacity)

      构造一个具有指定初始容量的空列表。

方法摘要
boolean add(E e)

      将指定的元素添加到此列表的尾部。

void add(int index, E element)

      将指定的元素插入此列表中的指定位置。

boolean addAll(Collection<? extends E> c)

      按照指定 collection 的迭代器所返回的元素顺序，将该 collection 中的所有元素添加到此列表的尾部。

boolean addAll(int index, Collection<? extends E> c)

      从指定的位置开始，将指定 collection 中的所有元素插入到此列表中。

void clear()

      移除此列表中的所有元素。

Object clone()

      返回此 ArrayList 实例的浅表副本。

boolean contains(Object o)

      如果此列表中包含指定的元素，则返回 true。

void ensureCapacity(int minCapacity)

      如有必要，增加此 ArrayList 实例的容量，以确保它至少能够容纳最小容量参数所指定的元素数。

E get(int index)

      返回此列表中指定位置上的元素。

int indexOf(Object o)

      返回此列表中首次出现的指定元素的索引，或如果此列表不包含元素，则返回 -1。

boolean isEmpty()

      如果此列表中没有元素，则返回 true 

int lastIndexOf(Object o)

      返回此列表中最后一次出现的指定元素的索引，或如果此列表不包含索引，则返回 -1。

E remove(int index)

      移除此列表中指定位置上的元素。

boolean remove(Object o)

      移除此列表中首次出现的指定元素（如果存在）。

protected void removeRange(int fromIndex, int toIndex)

      移除列表中索引在 fromIndex（包括）和 toIndex（不包括）之间的所有元素。

E set(int index, E element)

      用指定的元素替代此列表中指定位置上的元素。

int size()

      返回此列表中的元素数。

Object[] toArray()

      按适当顺序（从第一个到最后一个元素）返回包含此列表中所有元素的数组。

<T> T[]
toArray(T[] a)

      按适当顺序（从第一个到最后一个元素）返回包含此列表中所有元素的数组；返回数组的运行时类型是指定数组的运行时类型。

void trimToSize()

      将此 ArrayList 实例的容量调整为列表的当前大小。

*/
}