Java Collections addAll()方法及示例

java.util.Collection接口的addAll(Collection) 用于将Collection’collection’添加到这个现有的集合中。该方法返回一个布尔值，描述了操作的成功性。如果集合被添加，它返回true，否则返回false。

语法。

Collection.addAll(Collection<E> collection)

参数。该方法接受一个强制性的参数Collection类型的集合，它将被添加到这个集合中。

返回值。该方法返回一个 布尔值 ，描述操作的成功与否。如果集合被添加，它返回true，否则返回false。

异常情况。这个方法会抛出以下异常。

• UnsupportedOperationException： 如果添加操作不被这个集合所支持。
• ClassCastException： 如果指定的元素的类别阻止它被添加到这个集合中。
• NullPointerException： 如果指定的元素是空的，而这个集合不允许空的元素。
• IllegalArgumentException: 如果该元素的某些属性阻止它被添加到这个集合中。
• IllegalStateException： 如果由于插入限制，该元素目前不能被添加。

下面的例子说明了集合的addAll()方法。

例子1：使用LinkedList类

// Java code to illustrate boolean addAll()
  
import java.util.*;
import java.util.*;
  
public class LinkedListDemo {
    public static void main(String args[])
    {
  
        // Creating an empty LinkedList
        Collection<String>
            list = new LinkedList<String>();
  
        // A collection is created
        Collection<String>
            collect = new LinkedList<String>();
        collect.add("A");
        collect.add("Computer");
        collect.add("Portal");
        collect.add("for");
        collect.add("Geeks");
  
        // Displaying the list
        System.out.println("The LinkedList is: " + list);
  
        // Appending the collection to the list
        list.addAll(collect);
  
        // displaying the modified LinkedList
        System.out.println("The new linked list is: "
                           + list);
    }
}

输出。

The LinkedList is: []
The new linked list is: [A, Computer, Portal, for, Geeks]

例2：使用ArrayDeque类

// Java code to illustrate addAll() method
  
import java.util.*;
  
public class ArrayDequeDemo {
    public static void main(String args[])
    {
        // Creating an empty ArrayDeque
        Collection<String>
            de_que = new ArrayDeque<String>();
  
        // Creating a new ArrayDeque
        Collection<String>
            deque = new ArrayDeque<String>();
        deque.add("Welcome");
        deque.add("To");
        deque.add("Geeks");
        deque.add("4");
        deque.add("Geeks");
  
        // Displaying the list
        System.out.println("The ArrayDeque is: " + de_que);
  
        // Appending the collection to the list
        de_que.addAll(deque);
  
        // displaying the modified ArrayDeque
        System.out.println("The new ArrayDeque is: "
                           + de_que);
    }
}

输出。

The ArrayDeque is: []
The new ArrayDeque is: [Welcome, To, Geeks, 4, Geeks]

例3：使用ArrayList类

// Java code to illustrate boolean addAll()
  
import java.util.*;
  
public class LinkedListDemo {
    public static void main(String args[])
    {
  
        // Creating an empty ArrayList
        Collection<String>
            list = new ArrayList<String>();
  
        // A collection is created
        Collection<String>
            collect = new ArrayList<String>();
        collect.add("A");
        collect.add("Computer");
        collect.add("Portal");
        collect.add("for");
        collect.add("Geeks");
  
        // Displaying the list
        System.out.println("The ArrayList is: " + list);
  
        // Appending the collection to the list
        list.addAll(collect);
  
        // displaying the modified ArrayList
        System.out.println("The new ArrayList is: "
                           + list);
    }
}

输出。

The ArrayList is: []
The new ArrayList is: [A, Computer, Portal, for, Geeks]

例4：演示NullPointer异常

// Java code to illustrate boolean addAll()
  
import java.util.*;
  
public class LinkedListDemo {
    public static void main(String args[])
    {
  
        // Creating an empty ArrayList
        Collection<String>
            list = new ArrayList<String>();
  
        // A collection is created
        Collection<String> collect = null;
  
        // Displaying the list
        System.out.println("The ArrayList is: " + list);
  
        try {
            // Appending the collection to the list
            list.addAll(collect);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

输出。

The ArrayList is: []
Exception: java.lang.NullPointerException

参考资料: https://docs.oracle.com/javase/9/docs/api/java/util/Collection.html#addAll-java.util.Collection-