Interface Collection

La interface Collection es implementada por los conjuntos (sets) y las listas (lists). Esta interface declara una serie de métodos generales utilizables con Sets y Lists. La declaración o header de dichos métodos se puede ver ejecutando el comando > javap java.util.Collection en una ventana de MS-DOS. El resultado se muestra a continuación:

public interface java.util.Collection
{
public abstract boolean add(java.lang.Object); // opcional
public abstract boolean addAll(java.util.Collection); // opcional
public abstract void clear(); // opcional
public abstract boolean contains(java.lang.Object);
public abstract boolean containsAll(java.util.Collection);
public abstract boolean equals(java.lang.Object);
public abstract int hashCode();
public abstract boolean isEmpty();
public abstract java.util.Iterator iterator();
public abstract boolean remove(java.lang.Object); // opcional
public abstract boolean removeAll(java.util.Collection); // opcional
public abstract boolean retainAll(java.util.Collection); // opcional
public abstract int size();
public abstract java.lang.Object toArray()[];
public abstract java.lang.Object toArray(java.lang.Object[])[];
}

A partir del nombre, de los argumentos y del valor de retorno, la mayor parte de estos métodos resultan autoexplicativos. A continuación se introducen algunos comentarios sobre los aspectos que pueden resultar más novedosos de estos métodos. Los detalles se pueden consultar en la documentación de Java.

Los métodos indicados como “// opcional” (estos caracteres han sido introducidos por los autores de este manual) pueden no estar disponibles en algunas implementaciones, como por ejemplo en las clases que no permiten modificar sus objetos. Por supuesto dichos métodos deben ser definidos, pero lo que hacen al ser llamados es lanzar una UnsupportedOperationException.

El método add() trata de añadir un objeto a una colección, pero puede que no lo consiga si la colección es un set que ya tiene ese elemento. Devuelve true si el método ha llegado a modificar la colección. Lo mismo sucede con addAll(). El método remove() elimina un único elemento (si lo encuentra), y devuelve true si la colección ha sido modificada.

El método iterator() devuelve una referencia Iterator que permite recorrer una colección con los métodos next() y hasNext(). Permite también borrar el elemento actual con remove().

Los dos métodos toArray() permiten convertir una colección en un array.

Fuente: Aprenda Java como si estuviera en primero de la Universidad de Navarra