【JAVA】List.addAll 详解

List.addAll() 方法是 Java 中 List 接口提供的一个用于向一个 List 集合中添加另一个 List 集合中所有元素的方法。该方法可以方便地将一个 List 集合中的元素添加到另一个 List 集合中，从而使得代码变得更加简洁，功能更加优秀。

一、使用List.addAll方法的基本语法

public boolean addAll(Collection c)

上面是 List.addAll() 方法的基本语法，其中 Collection c 表示需要添加到 list 集合中的元素来源，该参数是一个 Collection 集合，也就是说， List.addAll() 方法的参数是一个 Collection 类型的参数。
List.addAll 方法遍历指定集合中的所有元素，并将它们逐个添加到调用该方法的列表的末尾。
它利用了列表的可变性质，通过修改列表本身来添加新的元素。

二、作用：

连接两个列表，将一个列表的所有元素添加到另一个列表的末尾。
从一个集合中添加多个元素到列表中。

注意事项：
.
添加的元素顺序与集合中元素的迭代顺序一致。 如果列表是有序的（如 ArrayList），则添加的元素将按照它们在集合中的顺序进行排列。
.
调用 addAll 方法会修改原始列表，将新元素添加到其末尾，而不创建一个新的列表对象。
.
如果集合中存在 null 元素，它们也会被添加到列表中。
.
注意避免出现循环引用的情况，比如在添加元素时不要将列表本身作为元素添加到自身中。

三、List.addAll方法的返回值

List.addAll() 方法的返回值为 boolean 类型，并且该返回值表示向集合中添加元素的操作是否成功。

如果该方法成功添加了新元素，返回值为 true；如果没有成功添加新元素，则返回值为 false。

四、使用List.addAll方法添加元素

我们通过 List.addAll() 方法可以方便地向一个 List 集合中添加另一个 List 集合中所有元素。下面是一个使用示例：

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

public class ListAddAllExample {
    public static void main(String[] args) {
        List list1 = new ArrayList<>();
        list1.add("a");
        list1.add("b");

        List list2 = new ArrayList<>();
        list2.add("c");
        list2.add("d");

        list1.addAll(list2);

        System.out.println(list1);
    }
}

输出结果为 [a, b, c, d]。
当list中有空元素的时候，如下图所示。

五、使用List.addAll方法的注意事项

1、参数不能为空

List.addAll() 方法接受的参数不能为空，如果传入的参数为 null，那么该方法会抛出 NullPointerException 异常。

2、List集合的初始大小要足够

当 List.addAll() 方法被调用时，List 集合的大小会随之增加。因此，在使用该方法前，应确保 List 集合的大小足够容纳需要添加的元素。

3、List集合的元素类型必须与需要添加的元素类型相同

List.addAll() 方法不能添加不同类型的元素，如果尝试向 List 集合中添加不同类型的元素，则会抛出 ClassCastException 异常。

六、结语

本篇文章介绍了 List.addAll() 方法的基本语法、返回值、使用方法及注意事项。通过本文的介绍，相信大家已经对于该方法的使用有了一定的了解和掌握。