Java Queue add()方法

Queue Interface 的 add(E e) 方法在有空间的情况下将参数中传递的元素插入到队列的末端。如果队列有容量限制，没有空间可以插入，它将返回 IllegalStateException。该函数在成功插入时返回true。

语法 :

boolean add(E e)

参数： 该方法接受一个强制性参数 e ，即要插入队列末端的元素。
返回： 该方法在成功插入时返回 true 。
异常： 该函数抛出四个异常，描述如下。

• ClassCastException ：当要输入的元素的类别阻止它被添加到这个容器中。
• IllegalStateException ：当容器的容量已满，并且插入已经完成。
• IllegalArgumentException : 当元素的某些属性阻止它被添加到队列中。
• NullPointerException ：当要插入的元素被传递为空，而队列的接口不允许空元素。

下面的程序说明了队列的add()方法：

程序1： 在 LinkedList 的帮助下 。

// Java Program Demonstrate add()
// method of Queue
 
import java.util.*;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new LinkedList<Integer>();
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
        Q.add(74381793);
 
        // before removing print queue
        System.out.println("Queue: " + Q);
    }
}

输出

Queue: [7855642, 35658786, 5278367, 74381793]

程序2： 在 ArrayDeque 的帮助下 。

// Java Program Demonstrate add()
// method of Queue
 
import java.util.*;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new ArrayDeque<Integer>();
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
        Q.add(74381793);
 
        // before removing print queue
        System.out.println("Queue: " + Q);
    }
}

输出

Queue: [7855642, 35658786, 5278367, 74381793]

程序3： 在 LinkedBlockingDeque 的帮助下 。

// Java Program Demonstrate add()
// method of Queue
 
import java.util.*;
import java.util.concurrent.LinkedBlockingDeque;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new LinkedBlockingDeque<Integer>();
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
        Q.add(74381793);
 
        // before removing print queue
        System.out.println("Queue: " + Q);
    }
}

输出

Queue: [7855642, 35658786, 5278367, 74381793]

程序4： 在 ConcurrentLinkedDeque 的帮助下 。

// Java Program Demonstrate add()
// method of Queue
 
import java.util.*;
import java.util.concurrent.ConcurrentLinkedDeque;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new ConcurrentLinkedDeque<Integer>();
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
        Q.add(74381793);
 
        // before removing print queue
        System.out.println("Queue: " + Q);
    }
}

输出

Queue: [7855642, 35658786, 5278367, 74381793]

下面的程序说明了 这个方法抛出的异常 ：

程序5： 显示 NullPointerException

// Java Program Demonstrate add()
// method of Queue when Null is passed
 
import java.util.*;
import java.util.concurrent.LinkedBlockingQueue;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new LinkedBlockingQueue<Integer>();
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
 
        try {
            // when null is inserted
            Q.add(null);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

输出

Exception: java.lang.NullPointerException

程序6： 显示 IllegalStateException

// Java Program Demonstrate add()
// method of Queue when capacity is full
import java.util.*;
import java.util.concurrent.LinkedBlockingQueue;
 
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
 
        // create object of Queue
        Queue<Integer> Q
            = new LinkedBlockingQueue<Integer>(3);
 
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
 
        try {
            // when capacity is full
            Q.add(10);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

输出

Exception: java.lang.IllegalStateException: Queue full

时间复杂度： O(1)

注意： 其他两个异常是内部的，是由编译器引起的，因此不能在编译器中显示。

参考资料 ：https://docs.oracle.com/javase/8/docs/api/java/util/Queue.html#add-E-