El método preserveAll() de la clase java.util.AbstractSequentialList se usa para retener de esta lista todos los elementos que están contenidos en la colección especificada.
Sintaxis:
public boolean retainAll(Collection c)
Parámetros: este método toma la colección c como un parámetro que contiene elementos que se conservarán de esta lista.
Valor devuelto: este método devuelve verdadero si esta lista cambió como resultado de la llamada.
Excepción: este método lanza NullPointerException si esta lista contiene un elemento nulo y la colección especificada no permite elementos nulos (opcional), o si la colección especificada es nula.
A continuación se muestran los ejemplos para ilustrar el método de retención() .
Ejemplo 1:
// Java program to demonstrate
// retainAll() method for Integer value
import java.util.*;
public class GFG1 {
public static void main(String[] argv) throws Exception
{
try {
// Creating object of AbstractSequentialList<Integer>
AbstractSequentialList<Integer>
arrlist1 = new LinkedList<Integer>();
// Populating arrlist1
arrlist1.add(1);
arrlist1.add(2);
arrlist1.add(3);
arrlist1.add(4);
arrlist1.add(5);
// print arrlist1
System.out.println("AbstractSequentialList before "
+ "retainAll() operation : "
+ arrlist1);
// Creating another object of AbstractSequentialList<Integer>
AbstractSequentialList<Integer>
arrlist2 = new LinkedList<Integer>();
arrlist2.add(1);
arrlist2.add(2);
arrlist2.add(3);
// print arrlist2
System.out.println("Collection Elements"
+ " to be retaind : "
+ arrlist2);
// Removing elements from arrlist
// specified in arrlist2
// using retainAll() method
arrlist1.retainAll(arrlist2);
// print arrlist1
System.out.println("AbstractSequentialList after "
+ "retainAll() operation : "
+ arrlist1);
}
catch (NullPointerException e) {
System.out.println("Exception thrown : " + e);
}
}
}
Producción:
AbstractSequentialList before retainAll() operation : [1, 2, 3, 4, 5] Collection Elements to be retaind : [1, 2, 3] AbstractSequentialList after retainAll() operation : [1, 2, 3]
Ejemplo 2: para NullPointerException
// Java program to demonstrate
// retainAll() method for Integer value
import java.util.*;
public class GFG1 {
public static void main(String[] argv) throws Exception
{
try {
// Creating object of AbstractSequentialList<Integer>
AbstractSequentialList<Integer>
arrlist1 = new LinkedList<Integer>();
// Populating arrlist1
arrlist1.add(1);
arrlist1.add(2);
arrlist1.add(3);
arrlist1.add(4);
arrlist1.add(5);
// print arrlist1
System.out.println("AbstractSequentialList before "
+ "retainAll() operation : "
+ arrlist1);
// Creating another object of AbstractSequentialList<Integer>
AbstractSequentialList<Integer>
arrlist2 = null;
// print arrlist2
System.out.println("Collection Elements"
+ " to be retaind : "
+ arrlist2);
System.out.println("\nTrying to pass "
+ "null as a specified element\n");
// Removing elements from arrlist
// specified in arrlist2
// using retainAll() method
arrlist1.retainAll(arrlist2);
// print arrlist1
System.out.println("AbstractSequentialList after "
+ "retainAll() operation : "
+ arrlist1);
}
catch (NullPointerException e) {
System.out.println("Exception thrown : " + e);
}
}
}
Producción:
AbstractSequentialList before retainAll() operation : [1, 2, 3, 4, 5] Collection Elements to be retaind : null Trying to pass null as a specified element Exception thrown : java.lang.NullPointerException