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:

java.lang.Cloneable, java.lang.Iterable<T>, java.util.Collection<T>

public final class NoDuplicatesCollection<T>
extends java.lang.Object
implements java.util.Collection<T>, java.lang.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(java.util.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(java.util.Collection<? extends T> c) Insere todos os elementos da coleção recebida.
void	clear()
NoDuplicatesCollection<T>	clone()
boolean	contains(java.lang.Object o)
boolean	containsAll(java.util.Collection<?> c)
boolean	equals(java.lang.Object obj)
java.lang.Object	getFirst() Retorna o primeiro elemento da coleção.
java.lang.Object	getLast() Retorna o último elemento da coleção.
int	hashCode()
boolean	isEmpty()
java.util.Iterator<T>	iterator()
boolean	remove(java.lang.Object o)
boolean	removeAll(java.util.Collection<?> c)
boolean	retainAll(java.util.Collection<?> c) Método não implementado.
int	size()
java.lang.Object[]	toArray()
<T> T[]	toArray(T[] a)
java.lang.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(java.util.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:

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

Method Detail

size

public int size()

Specified by:

size in interface java.util.Collection<T>

clear

public void clear()

Specified by:

clear in interface java.util.Collection<T>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Collection<T>

toArray

public java.lang.Object[] toArray()

Specified by:

toArray in interface java.util.Collection<T>

getFirst

public java.lang.Object getFirst()
                          throws java.util.NoSuchElementException

Retorna o primeiro elemento da coleção.

Returns:

O primeiro elemento da coleção.

Throws:

java.util.NoSuchElementException - Caso a coleção esteja vazia.

getLast

public java.lang.Object getLast()
                         throws java.util.NoSuchElementException

Retorna o último elemento da coleção.

Returns:

O último elemento da coleção.

Throws:

java.util.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 java.util.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:

java.lang.IllegalArgumentException - Caso o elemento recebido seja nulo.

See Also:

Collection.add(java.lang.Object)

contains

public boolean contains(java.lang.Object o)

Specified by:

contains in interface java.util.Collection<T>

remove

public boolean remove(java.lang.Object o)

Specified by:

remove in interface java.util.Collection<T>

addAll

public boolean addAll(java.util.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 java.util.Collection<T>

Parameters:

c - A coleção de origem.

Returns:

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

Throws:

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

See Also:

Collection.addAll(java.util.Collection)

containsAll

public boolean containsAll(java.util.Collection<?> c)

Specified by:

containsAll in interface java.util.Collection<T>

removeAll

public boolean removeAll(java.util.Collection<?> c)

Specified by:

removeAll in interface java.util.Collection<T>

retainAll

public boolean retainAll(java.util.Collection<?> c)

Método não implementado.

Specified by:

retainAll in interface java.util.Collection<T>

See Also:

Collection.retainAll(java.util.Collection)

iterator

public java.util.Iterator<T> iterator()

Specified by:

iterator in interface java.lang.Iterable<T>

Specified by:

iterator in interface java.util.Collection<T>

clone

public NoDuplicatesCollection<T> clone()

Overrides:

clone in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Specified by:

equals in interface java.util.Collection<T>

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Collection<T>

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toArray

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

Specified by:

toArray in interface java.util.Collection<T>