Java中的 ConcurrentLinkedDeque addAll() 方法及示例

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

句法：

public boolean addAll(Collection c)

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

返回值：此方法返回一个布尔值，说明集合是否附加到双端队列。

异常：此方法接受两个异常：

• NullPointerException：如果集合中存在的任何元素为 null 或集合为 null。
• IllegalArgumentException：如果传递的集合本身是现有的双端队列。

下面的示例说明了 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 ld1
            = new ConcurrentLinkedDeque();
  
        // 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 ld2
            = new ConcurrentLinkedDeque();
  
        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 ld1
            = new ConcurrentLinkedDeque();
  
        // 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 ld1
            = new ConcurrentLinkedDeque();
  
        // 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 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: Java/util/concurrent/ConcurrentLinkedDeque.html