csbase.util.collections

Class NoDuplicatesCollection<T>

java.lang.Object

csbase.util.collections.NoDuplicatesCollection<T>

Type Parameters:

T - tipo do objeto a ser armazenado na coleção

All Implemented Interfaces:

Cloneable, Iterable<T>, Collection<T>

public final class NoDuplicatesCollection<T>
extends Object
implements Collection<T>, Cloneable

Representa uma coleção que não contém elementos duplicados e não contém elementos nulos (null).

A diferença desta coleção para um Set é que ao inserirmos elementos que já façam parte da coleção, eles são colocados no final da coleção e será informado que houve mudança na coleção. No caso do Set, a coleção permaneceria sem modificações.

Todos os elementos devem ser clonáveis, ou o método clone() levantará uma CloneNotSupportedException.

Author:

Rodrigo Carneiro Henrique (rodrigoh)

Constructor Summary

Constructors

Constructor and Description
NoDuplicatesCollection() Cria uma coleção vazia.
NoDuplicatesCollection(Collection<T> c) Cria uma coleção contendo os elementos da coleção recebida.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	add(T o) Insere o elemento na última posição da coleção.
boolean	addAll(Collection<? extends T> c) Insere todos os elementos da coleção recebida.
void	clear()
NoDuplicatesCollection<T>	clone()
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
boolean	equals(Object obj)
Object	getFirst() Retorna o primeiro elemento da coleção.
Object	getLast() Retorna o último elemento da coleção.
int	hashCode()
boolean	isEmpty()
Iterator<T>	iterator()
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c) Método não implementado.
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] a)
String	toString()

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

NoDuplicatesCollection

public NoDuplicatesCollection()

Cria uma coleção vazia.

NoDuplicatesCollection

public NoDuplicatesCollection(Collection<T> c)

Cria uma coleção contendo os elementos da coleção recebida. Todos os elementos duplicados serão removidos.

Parameters:

c - A coleção com os elementos a serem inseridos.

Throws:

IllegalArgumentException - Caso a coleção passada como parâmetro seja nula (null).

Method Detail

size

public int size()

Specified by:

size in interface Collection<T>

clear

public void clear()

Specified by:

clear in interface Collection<T>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<T>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<T>

getFirst

public Object getFirst()
                throws NoSuchElementException

Retorna o primeiro elemento da coleção.

Returns:

O primeiro elemento da coleção.

Throws:

NoSuchElementException - Caso a coleção esteja vazia.

getLast

public Object getLast()
               throws NoSuchElementException

Retorna o último elemento da coleção.

Returns:

O último elemento da coleção.

Throws:

NoSuchElementException - Caso a coleção esteja vazia.

add

public boolean add(T o)

Insere o elemento na última posição da coleção.

• Caso o elemento não esteja na coleção, ele é inserido na última posição.
• Caso o elemento já esteja na coleção e esteja na última posição, nada é feito.
• Caso o elemento já esteja na coleção e não esteja na última posição, será movido para a última posição.

Specified by:

add in interface Collection<T>

Parameters:

o - O objeto a ser inserido na coleção.

Returns:

true, se a coleção foi alterada, ou false, caso contrário.

Throws:

IllegalArgumentException - Caso o elemento recebido seja nulo.

See Also:

Collection.add(java.lang.Object)

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<T>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T>

addAll

public boolean addAll(Collection<? extends T> c)

Insere todos os elementos da coleção recebida. Possui o mesmo funcionamento do método add(Object). Conforme os elementos vão aparecendo na coleção de origem, eles vão sendo inseridos ao final da coleção destino (a instância atual). Elementos repetidos são movidos para o final.

Specified by:

addAll in interface Collection<T>

Parameters:

c - A coleção de origem.

Returns:

true, se a coleção foi alterada, ou false, caso contrário.

Throws:

IllegalArgumentException - Caso a coleção passada como parâmetro seja nula (null).

See Also:

Collection.addAll(java.util.Collection)

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<T>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<T>

retainAll

public boolean retainAll(Collection<?> c)

Método não implementado.

Specified by:

retainAll in interface Collection<T>

See Also:

Collection.retainAll(java.util.Collection)

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Iterable<T>

Specified by:

iterator in interface Collection<T>

clone

public NoDuplicatesCollection<T> clone()

Overrides:

clone in class Object

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<T>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<T>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<T>