oracle.ucp.util

Interface Chain<T>

Type Parameters:

T - type of a chain element

All Known Implementing Classes:

ListChain, MapChain

public interface 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).

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Chain.Atom<T> Atom of a chain

Method Summary

Modifier and Type	Method and Description
Chain.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

Method Detail

add

Chain.Atom add(T data)

Add an atom to this chain

Parameters:

data - atom's data to add

forEach

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

Do something for each atom in a chaain

Parameters:

consumer - defines what to do

toList

List<T> toList()

Returns chains elements in a standard list

toArray

T[] toArray()

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

clear

void clear()

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