oracle.ucp.util

Class ListChain<T>

java.lang.Object

oracle.ucp.util.ListChain<T>

Type Parameters:

T - type of a chain element

All Implemented Interfaces:

Chain<T>

public class ListChain<T>
extends Object
implements Chain<T>

Thread-safe stack chain with effectively removable handled atoms from the middle of a chain. Atom addition works like in a stack. Atom removal works like in a double linked list: it is possible to quickly remove any atom from any position, it is just enough to have it's handle, it is not necessary to even have a chain itself (an atom internally refers to a chain). TODO - this class is a candidate for further optimization: it would be nice to lock fragments of a chain (instead of locking a whole one) while adding/removing atoms. That way this class is going to be handled even faster.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ListChain.Atom Chain's atom

Constructor Summary

Constructors

Constructor and Description
ListChain()

Method Summary

Modifier and Type	Method and Description
ListChain.Atom	add(T data) Add an atom to this chain
void	clear() clear chain (data will be lost, so if need to save, navigate and save prior to clearing)
void	forEach(java.util.function.Consumer<T> consumer) Do something for each atom in a chaain
T[]	toArray() Returns an array of chain's elements returns array of chain's elements
List<T>	toList() Returns chains elements in a standard list
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ListChain

public ListChain()

Method Detail

add

public ListChain.Atom add(T data)

Description copied from interface: Chain

Add an atom to this chain

Specified by:

add in interface Chain<T>

Parameters:

data - atom's data to add

See Also:

oracle.ucp.util.Chain#add(T)

forEach

public void forEach(java.util.function.Consumer<T> consumer)

Description copied from interface: Chain

Do something for each atom in a chaain

Specified by:

forEach in interface Chain<T>

Parameters:

consumer - defines what to do

See Also:

Chain.forEach(Consumer)

toList

public List<T> toList()

Description copied from interface: Chain

Returns chains elements in a standard list

Specified by:

toList in interface Chain<T>

See Also:

Chain.toList()

toArray

public T[] toArray()

Description copied from interface: Chain

Returns an array of chain's elements returns array of chain's elements

Specified by:

toArray in interface Chain<T>

See Also:

Chain.toArray()

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()

clear

public void clear()

Description copied from interface: Chain

clear chain (data will be lost, so if need to save, navigate and save prior to clearing)

Specified by:

clear in interface Chain<T>

See Also:

Chain.clear()