Java ConcurrentLinkedDeque addAll()方法及示例

ConcurrentLinkedDeque 的 addAll(Collection col) 方法以col为参数，其中col是一个元素集合（List、ArrayList、LinkedList等）。整个集合被追加或添加到Dequeue的末尾。这个方法就像add()方法一样，如果该集合被添加到Deque中，则返回true。

语法

public boolean addAll(Collection c)

参数： 该函数接受一个参数col，即要添加的元素的集合。

返回值： 该方法返回 一个布尔值 ，说明该集合是否被追加到Deque中。

异常： 该方法接受两种异常。

• NullPointerException： 如果集合中的任何元素是空的或者集合是空的。
• IllegalArgumentException： 如果传递的集合是现有的deque本身。

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

例1：将数字集合添加到ConcurrentLinkedDeque的第一个集合中

// Java program to illustrate addAll() method
  
import java.util.concurrent.ConcurrentLinkedDeque;
  
public class Example1 {
    public static void main(String[] args)
    {
  
        // create object of ConcurrentLinkedDeque
        ConcurrentLinkedDeque<Integer> ld1
            = new ConcurrentLinkedDeque<Integer>();
  
        // Add elements
        ld1.add(1);
        ld1.add(2);
        ld1.add(3);
        ld1.add(4);
  
        // print ld1
        System.out.println("LD1: " + ld1);
  
        // create object of ConcurrentLinkedDeque
        ConcurrentLinkedDeque<Integer> ld2
            = new ConcurrentLinkedDeque<Integer>();
  
        ld2.add(8);
        ld2.add(1);
        ld2.add(3);
        ld2.add(5);
  
        // print ld2
        System.out.println("LD2: " + ld2);
  
        // Adding elements of ld2 to ld1 at its end.
        ld1.addAll(ld2);
  
        System.out.println("After adding the ld2 to ld1: "
                           + ld1);
    }
}

输出。

LD1: [1, 2, 3, 4]
LD2: [8, 1, 3, 5]
After adding the ld2 to ld1: [1, 2, 3, 4, 8, 1, 3, 5]

例2：显示IllegalArgumentException

// Java program to illustrate addAll() method
  
import java.util.concurrent.ConcurrentLinkedDeque;
  
public class Example2 {
    public static void main(String[] args)
    {
        // create object of ConcurrentLinkedDeque
        ConcurrentLinkedDeque<String> ld1
            = new ConcurrentLinkedDeque<String>();
  
        // Add elements
        ld1.add("John");
        ld1.add("Johnathan");
        ld1.add("Jones");
        ld1.add("James");
  
        // print ld1
        System.out.println("LD1: " + ld1);
  
        try {
            ld1.addAll(ld1);
        }
        catch (IllegalArgumentException e) {
            System.out.println("Exception thrown while "
                               + "adding deque to "
                               + "itself is: "
                               + e);
        }
    }
}

输出。

LD1: [John, Johnathan, Jones, James]
Exception thrown while adding deque to itself is: java.lang.IllegalArgumentException

例3：显示NullPointerException

// Java program to illustrate addAll() method
  
import java.util.concurrent.ConcurrentLinkedDeque;
  
public class Example3 {
    public static void main(String[] args)
    {
  
        // create object of ConcurrentLinkedDeque
        ConcurrentLinkedDeque<String> ld1
            = new ConcurrentLinkedDeque<String>();
  
        // Add elements
        ld1.add("John");
        ld1.add("Johnathan");
        ld1.add("Jones");
        ld1.add("James");
  
        // print ld1
        System.out.println("LD1: " + ld1);
  
        // create object of ConcurrentLinkedDeque
        ConcurrentLinkedDeque<String> ld2 = null;
  
        // print ld2
        System.out.println("LD2: " + ld2);
  
        try {
  
            System.out.println("After adding the ld2 to ld1: ");
            ld2.addAll(ld1);
        }
        catch (NullPointerException e) {
            System.out.println(e);
        }
    }
}

输出。

LD1: [John, Johnathan, Jones, James]
LD2: null
After adding the ld2 to ld1: 
java.lang.NullPointerException

参考资料 : https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ConcurrentLinkedDeque.html