Método PriorityBlockingQueue add() en Java

El método add(E e) de PriorityBlockingQueue inserta el elemento pasado como parámetro al método al final de esta PriorityBlockingQueue. Este método devuelve verdadero si la adición del elemento es exitosa. De lo contrario, devuelve falso. 

Sintaxis:

public boolean add(E e)

Parámetro: este método toma un parámetro obligatorio e que es el elemento que se insertará en PriorityBlockingQueue. 

Devoluciones: este método devuelve una respuesta booleana . Devuelve verdadero si la adición del elemento es exitosa, de lo contrario devuelve falso . 

Excepción: este método arroja las siguientes excepciones:

• ClassCastException: si el elemento pasado como parámetro no se puede comparar con el elemento contenido en la cola para mantener el orden de prioridad de la cola.
• NullPointerException: si el elemento pasado como parámetro es nulo.

El siguiente programa ilustra el método add() de PriorityBlockingQueue: 

Ejemplo 1: 

// Java Program to Demonstrate add(E e) method
// of PriorityBlockingQueue.
 
import java.util.concurrent.PriorityBlockingQueue;
 
public class GFG {
 
    public static void main(String[] args)
    {
        // define capacity of PriorityBlockingQueue
        int capacity = 15;
 
        // create object of PriorityBlockingQueue
        PriorityBlockingQueue<Integer> PrioBlockingQueue
            = new PriorityBlockingQueue<Integer>(capacity);
 
        // add  numbers
        PrioBlockingQueue.add(526734);
        PrioBlockingQueue.add(84879456);
        PrioBlockingQueue.add(4586415);
 
        // print queue after add operation
        System.out.println("After Adding Some Numbers");
        System.out.println("PriorityBlockingQueue:"
                           + PrioBlockingQueue);
 
        // add more numbers
        PrioBlockingQueue.add(156116);
        PrioBlockingQueue.add(61651191);
 
        // print queue after add operation
        System.out.println("\nAfter adding Some More Numbers");
        System.out.println("PriorityBlockingQueue:"
                           + PrioBlockingQueue);
    }
}

After Adding Some Numbers
PriorityBlockingQueue:[526734, 84879456, 4586415]

After adding Some More Numbers
PriorityBlockingQueue:[156116, 526734, 4586415, 84879456, 61651191]

Ejemplo 2: para demostrar NullPointerException lanzada por el método add(). 

// Java Program to Demonstrate Exception
// thrown by add(E e) method
// of PriorityBlockingQueue.
 
import java.util.concurrent.PriorityBlockingQueue;
 
public class GFG {
 
    public static void main(String[] args)
    {
        // define capacity of PriorityBlockingQueue
        int capacity = 15;
 
        // create object of PriorityBlockingQueue
        PriorityBlockingQueue<Integer> PrioBlockingQueue
            = new PriorityBlockingQueue<Integer>(capacity);
 
        // add numbers
        PrioBlockingQueue.add(526734);
        PrioBlockingQueue.add(84879456);
        PrioBlockingQueue.add(4586415);
        try {
            // try to add null to PrioBlockingQueue
            PrioBlockingQueue.add(null);
 
            // print PrioBlockingQueue after add operation
            System.out.println("PriorityBlockingQueue:"
                               + PrioBlockingQueue);
        }
        catch (Exception e) {
            System.out.println("Exception when adding null: "
                               + e);
        }
    }
}

Exception when adding null: java.lang.NullPointerException

Referencia: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/PriorityBlockingQueue.html#add-E-