org.fuin.utils4j
Class ChangeTrackingUniqueList

java.lang.Object
  org.fuin.utils4j.ChangeTrackingUniqueList

All Implemented Interfaces:

java.lang.Iterable, java.util.Collection, java.util.List

public class ChangeTrackingUniqueList
extends java.lang.Object
implements java.util.List

A wrapper for lists that keeps track of all changes made to the list since construction. Only adding, replacing or deleting elements is tracked (not changes inside the objects). Duplicates elements are not allowed for the list - This is like a Set but at the same time ordered like a List . It's also possible to revert all changes.

Constructor Summary

ChangeTrackingUniqueList(java.util.List list)
Constructor with covered list.

Method Summary

void	add(int index, java.lang.Object o)
boolean	add(java.lang.Object o)
boolean	addAll(java.util.Collection c)
boolean	addAll(int index, java.util.Collection c)
void	clear()
boolean	contains(java.lang.Object o)
boolean	containsAll(java.util.Collection c)
java.lang.Object	get(int index)
java.util.List	getAdded() Returns added elements.
java.util.List	getDeleted() Returns deleted elements.
int	indexOf(java.lang.Object o)
boolean	isChanged() Returns if the list has changed.
boolean	isEmpty()
java.util.Iterator	iterator()
int	lastIndexOf(java.lang.Object o)
java.util.ListIterator	listIterator()
java.util.ListIterator	listIterator(int index)
java.lang.Object	remove(int index)
boolean	remove(java.lang.Object o)
boolean	removeAll(java.util.Collection c)
boolean	retainAll(java.util.Collection c)
void	revert() Roll back all changes made since construction.
java.lang.Object	set(int index, java.lang.Object o)
int	size()
java.util.List	subList(int fromIndex, int toIndex)
java.lang.Object[]	toArray()
java.lang.Object[]	toArray(java.lang.Object[] a)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

equals, hashCode

Constructor Detail

ChangeTrackingUniqueList

public ChangeTrackingUniqueList(java.util.List list)

Constructor with covered list.

Parameters:

list - Wrapped list - Be aware that this list will be changed by this class. There is no internal copy of the list - The reference itself is used.

Method Detail

isChanged

public final boolean isChanged()

Returns if the list has changed.

Returns:

If elements have been added or deleted true else false.

getDeleted

public final java.util.List getDeleted()

Returns deleted elements.

Returns:

Elements that have been deleted since construction of this instance.

getAdded

public final java.util.List getAdded()

Returns added elements.

Returns:

Elements that have been added since construction of this instance.

revert

public final void revert()

Roll back all changes made since construction. WARNING: The position of the elements is not guaranteed to be the same again!

add

public final boolean add(java.lang.Object o)

Specified by:

add in interface java.util.Collection

Specified by:

add in interface java.util.List

add

public final void add(int index,
                      java.lang.Object o)

Specified by:

add in interface java.util.List

addAll

public final boolean addAll(java.util.Collection c)

Specified by:

addAll in interface java.util.Collection

Specified by:

addAll in interface java.util.List

addAll

public final boolean addAll(int index,
                            java.util.Collection c)

Specified by:

addAll in interface java.util.List

clear

public final void clear()

Specified by:

clear in interface java.util.Collection

Specified by:

clear in interface java.util.List

contains

public final boolean contains(java.lang.Object o)

Specified by:

contains in interface java.util.Collection

Specified by:

contains in interface java.util.List

containsAll

public final boolean containsAll(java.util.Collection c)

Specified by:

containsAll in interface java.util.Collection

Specified by:

containsAll in interface java.util.List

get

public final java.lang.Object get(int index)

Specified by:

get in interface java.util.List

indexOf

public final int indexOf(java.lang.Object o)

Specified by:

indexOf in interface java.util.List

isEmpty

public final boolean isEmpty()

Specified by:

isEmpty in interface java.util.Collection

Specified by:

isEmpty in interface java.util.List

iterator

public final java.util.Iterator iterator()

Specified by:

iterator in interface java.lang.Iterable

Specified by:

iterator in interface java.util.Collection

Specified by:

iterator in interface java.util.List

lastIndexOf

public final int lastIndexOf(java.lang.Object o)

Specified by:

lastIndexOf in interface java.util.List

listIterator

public final java.util.ListIterator listIterator()

Specified by:

listIterator in interface java.util.List

listIterator

public final java.util.ListIterator listIterator(int index)

Specified by:

listIterator in interface java.util.List

remove

public final boolean remove(java.lang.Object o)

Specified by:

remove in interface java.util.Collection

Specified by:

remove in interface java.util.List

remove

public final java.lang.Object remove(int index)

Specified by:

remove in interface java.util.List

removeAll

public final boolean removeAll(java.util.Collection c)

Specified by:

removeAll in interface java.util.Collection

Specified by:

removeAll in interface java.util.List

retainAll

public final boolean retainAll(java.util.Collection c)

Specified by:

retainAll in interface java.util.Collection

Specified by:

retainAll in interface java.util.List

set

public final java.lang.Object set(int index,
                                  java.lang.Object o)

Specified by:

set in interface java.util.List

size

public final int size()

Specified by:

size in interface java.util.Collection

Specified by:

size in interface java.util.List

subList

public final java.util.List subList(int fromIndex,
                                    int toIndex)

Specified by:

subList in interface java.util.List

toArray

public final java.lang.Object[] toArray()

Specified by:

toArray in interface java.util.Collection

Specified by:

toArray in interface java.util.List

toArray

public final java.lang.Object[] toArray(java.lang.Object[] a)

Specified by:

toArray in interface java.util.Collection

Specified by:

toArray in interface java.util.List

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object