Colección add() Método en Java con ejemplos

El complemento (elemento E) de la interfaz java.util.Collection se utiliza para agregar el elemento ‘elemento’ a esta colección. Este método devuelve un valor booleano que representa el éxito de la operación. Si se agregó el elemento, devuelve verdadero, de lo contrario, devuelve falso.

Sintaxis: 

Collection.add(E element)

Parámetros: este método acepta un elemento de parámetro obligatorio de tipo E que se agregará a esta colección.

Valor de retorno: un valor booleano que representa el éxito de la operación. Si se agregó el elemento, devuelve verdadero, de lo contrario, devuelve falso.

Excepciones: este método genera las siguientes 5 excepciones que se enumeran a continuación de la siguiente manera:

• UnsupportedOperationException: si la operación de agregar no es compatible con esta colección
• ClassCastException: si la clase del elemento especificado impide que se agregue a esta colección
• NullPointerException: si el elemento especificado es nulo y esta colección no permite elementos nulos
• IllegalArgumentException: si alguna propiedad del elemento impide que se agregue a esta colección
• IllegalStateException: si el elemento no se puede agregar en este momento debido a restricciones de inserción

Ahora implementaremos este método en diferentes clases, ya que es un método muy importante y esencial cuando se trata de programación Java, por lo que aquí enfatizaremos cada clase de la siguiente manera:

• clase LinkedList
• ArrayDeque
• clase ArrayList
• Se lanza la excepción NullPointerException

Implementemos el método add() en los 4 casos enumerados anteriormente a través de ejemplos limpios de Java de la siguiente manera:

Ejemplo 1: clase LinkedList

// Java code to illustrate boolean add() method
 
import java.io.*;
import java.util.*;
 
public class GFG {
    public static void main(String args[])
    {
 
        // creating an empty LinkedList
        Collection<String> list = new LinkedList<String>();
 
        // use add() method to add elements in the list
        list.add("Geeks");
        list.add("for");
        list.add("Geeks");
 
        // Output the present list
        System.out.println("The list is: " + list);
 
        // Adding new elements to the end
        list.add("Last");
        list.add("Element");
 
        // printing the new list
        System.out.println("The new List is: " + list);
    }
}

The list is: [Geeks, for, Geeks]
The new List is: [Geeks, for, Geeks, Last, Element]

Ejemplo 2: Clase ArrayDeque 

// Java code to illustrate add() method
 
import java.util.*;
 
public class ArrayDequeDemo {
    public static void main(String args[])
    {
        // Creating an empty ArrayDeque
        Collection<String> de_que = new ArrayDeque<String>();
 
        // Use add() method to add elements into the Deque
        de_que.add("Welcome");
        de_que.add("To");
        de_que.add("Geeks");
        de_que.add("4");
        de_que.add("Geeks");
 
        // Displaying the ArrayDeque
        System.out.println("ArrayDeque: " + de_que);
    }
}

ArrayDeque: [Welcome, To, Geeks, 4, Geeks]

Ejemplo 3: uso de la clase ArrayList 

// Java code to illustrate add() method
 
import java.io.*;
import java.util.*;
 
public class ArrayListDemo {
    public static void main(String[] args)
    {
 
        // create an empty array list with an initial capacity
        Collection<Integer> arrlist = new ArrayList<Integer>(5);
 
        // use add() method to add elements in the list
        arrlist.add(15);
        arrlist.add(20);
        arrlist.add(25);
 
        // prints all the elements available in list
        for (Integer number : arrlist) {
            System.out.println("Number = " + number);
        }
    }
}

Number = 15
Number = 20
Number = 25

Los geeks mantienen un límite sobre el caso especial en el que se lanzará la excepción NullPointer como se muestra en el siguiente ejemplo:

Ejemplo 4:

// Java code to illustrate boolean add()
// Where NullPointerException is Thrown
 
// Importing required utility classes
import java.util.*;
 
// Main class
// LinkedListDemo
class GFG {
 
    // Main driver method
    public static void main(String args[])
    {
 
        // Creating an empty ArrayList of string type
        Collection<String> list = new ArrayList<String>();
 
        // Printing and displaying the Arraylist
        System.out.println("The ArrayList is: " + list);
 
        // Note: Here by now we have not added any element/s
 
        // Try block to check for exceptions
        try {
 
            // Appending the null to the list
            // using add() method
            list.add(null);
        }
 
        // Catch block to handle exceptions
        catch (Exception e) {
 
            // Display message when exceptions occurs
            System.out.println("Exception: " + e);
        }
    }
}

The ArrayList is: []

Explicación de salida: Aquí debemos recogerlo ya que solo recibiremos una Lista. Por lo tanto, es una buena práctica documentar el método add(), ya sea que lo esté aceptando si necesita admitir nulo.