Método BlockingDeque push() en Java con ejemplos

El método push(E e) de BlockingDeque empuja un elemento a la pila representada por este deque. Inserta el elemento pasado en el parámetro al frente del Deque si hay espacio. Si BlockingDeque tiene una capacidad restringida y no queda espacio para la inserción, devuelve una IllegalStateException . Esta función es similar a la de addFirst().

Sintaxis:  

public void push(E e)

Parámetros: este método acepta un parámetro obligatorio e que es el elemento que se insertará al principio de LinkedBlockingDeque. 

Nota : El método push() de BlockingDeque se ha heredado de la clase LinkedBlockingDeque en Java.

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

Los siguientes programas ilustran el método push() de BlockingDeque:

Programa 1:  

// Java Program Demonstrate push()
// 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.push(7855642);
        BD.push(35658786);
        BD.push(5278367);
        BD.push(74381793);
 
        // before removing print queue
        System.out.println("Blocking Deque: " + BD);
    }
}

Blocking Deque: [74381793, 5278367, 35658786, 7855642]

Programa 2: 

// Java Program Demonstrate push()
// 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> LBD
            = new LinkedBlockingDeque<Integer>(3);
 
        // Add numbers to end of BlockingDeque
        BD.push(7855642);
        BD.push(35658786);
        BD.push(5278367);
 
        // it is full
        BD.push(74381793);
 
        // before removing print queue
        System.out.println("Blocking Deque: " + BD);
    }
}

Producción: 

Exception in thread "main" java.lang.IllegalStateException: Deque full
    at java.util.concurrent.LinkedBlockingDeque.addFirst(LinkedBlockingDeque.java:326)
    at java.util.concurrent.LinkedBlockingDeque.push(LinkedBlockingDeque.java:770)
    at GFG.main(GFG.java:24)

Programa 3: 

// Java Program Demonstrate push()
// 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.push(7855642);
        BD.push(35658786);
        BD.push(5278367);
 
        // NULL
        BD.push(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.offerFirst(LinkedBlockingDeque.java:342)
    at java.util.concurrent.LinkedBlockingDeque.addFirst(LinkedBlockingDeque.java:325)
    at java.util.concurrent.LinkedBlockingDeque.push(LinkedBlockingDeque.java:770)
    at GFG.main(GFG.java:24)

Referencia: https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/BlockingDeque.html#push(E)