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 jara.útil. Collection en una ventana de MS-DOS. El resultado se muestra a continuación:

public interface java.útil.Collection
{

public      abstract                                boolean add(java.lang.Object);                              // opcional

public      abstract                                boolean addAll(java.útil.Collection);                       // opcional

public      abstract                                void clear(); // opcional

public      abstract   boolean contains(java.lang.Object);

public      abstract   boolean containsAll(java.útil.Collection);

public      abstract   boolean equals(java.lang.Object);

public      abstract   int hashCode();

public      abstract   boolean isEmptyO;

public      abstract   java.útil.Iterator iterator();

public      abstract                                boolean remove(java.lang.Object);                           // opcional

public      abstract   boolean removeAll(java.útil.Collection); // opcional

public      abstract   boolean retainAll(java.útil.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 retomo, la mayor paite de estos métodos resultan autoexplicativos. A continuación se introducen algunos coméntanos 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) no están 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 UusupportedOperatiouException. 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 addAllf). El método removef) elimina un único elemento (si lo encuentra); devuelve true si la colección ha sido modificada. El método iteratorQ devuelve una referencia Iterator que permite recorrer una colección con los métodos uext() y hasNext(). Permite también borrar el elemento actual con retnove(). Los dos métodos toArray() permiten convertir una colección en un array.