El método add(E e) de BlockingDeque inserta el elemento pasado en el parámetro al final de Deque si hay espacio. Si BlockingDeque tiene una capacidad restringida y no queda espacio para la inserción, devuelve una IllegalStateException . Funciona exactamente de la misma manera que lo hace el método addLast().
Sintaxis:
public void add(E e)
Parámetros: Este método acepta un parámetro obligatorio e que es el elemento a insertar al final del BlockingDeque.
Devoluciones: Este método no devuelve nada.
Excepción:
- IllegalStateException : si el elemento no se puede agregar en este momento debido a restricciones de capacidad
- NullPointerException : si el elemento especificado es nulo
Nota : El método add() de BlockingDeque se ha heredado de la clase LinkedBlockingDeque en Java.
Los siguientes programas ilustran el método add() de Deque:
Programa 1:
// Java Program Demonstrate add() // method of BlockingDeque import java.util.concurrent.LinkedBlockingDeque; import java.util.concurrent.BlockingDeque; import java.util.*; public class GFG { public static void main(String[] args) throws IllegalStateException { // create object of BlockingDeque BlockingDeque<Integer> BD = new LinkedBlockingDeque<Integer>(); // Add numbers to end of BlockingDeque BD.add(7855642); BD.add(35658786); BD.add(5278367); BD.add(74381793); // before removing print queue System.out.println("Blocking Deque: " + BD); } }
Blocking Deque: [7855642, 35658786, 5278367, 74381793]
Programa 2:
// Java Program Demonstrate add() // method of BlockingDeque // when it is Full import java.util.concurrent.LinkedBlockingDeque; import java.util.concurrent.BlockingDeque; import java.util.*; public class GFG { public static void main(String[] args) throws IllegalStateException { // create object of BlockingDeque // size of list BlockingDeque<Integer> BD = new LinkedBlockingDeque<Integer>(3); // Add numbers to end of BlockingDeque BD.add(7855642); BD.add(35658786); BD.add(5278367); // it is full BD.add(74381793); // before removing print Deque System.out.println("Blocking Deque: " + BD); } }
Producción:
Exception in thread "main" java.lang.IllegalStateException: Deque full at java.util.concurrent.LinkedBlockingDeque.addLast(LinkedBlockingDeque.java:335) at java.util.concurrent.LinkedBlockingDeque.add(LinkedBlockingDeque.java:633) at GFG.main(GFG.java:24)
Programa 3:
// Java Program Demonstrate add() // method of BlockingDeque // when null is inserted import java.util.concurrent.LinkedBlockingDeque; import java.util.concurrent.BlockingDeque; import java.util.*; public class GFG { public static void main(String[] args) throws IllegalStateException { // create object of BlockingDeque BlockingDeque<Integer> BD = new LinkedBlockingDeque<Integer>(); // Add numbers to end of BlockingDeque BD.add(7855642); BD.add(35658786); BD.add(5278367); // NULL BD.add(null); // before removing print Deque System.out.println("Blocking Deque: " + BD); } }
Producción:
Exception in thread "main" java.lang.NullPointerException at java.util.concurrent.LinkedBlockingDeque.offerLast(LinkedBlockingDeque.java:357) at java.util.concurrent.LinkedBlockingDeque.addLast(LinkedBlockingDeque.java:334) at java.util.concurrent.LinkedBlockingDeque.add(LinkedBlockingDeque.java:633) at GFG.main(GFG.java:23)
Referencia: https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/BlockingDeque.html#add(E)