rac
Interface IRAContainer<T>

All Known Implementing Classes:

ALRSRACFactory.LRSRAContainer

public interface IRAContainer<T>

Defines the interface for a restricted access container.

Method Summary

void	clear() Empty the container.
IList<T>	elements(IListFactory<T> fact) Return an immutable list of all elements in the container.
<R,P> R	execute(IRACVisitor<T,R,P> v, P... inp) Extensibility hook to accept a visitor algorithm.
T	get() Remove the next item from the container and return it.
boolean	isFull() Return TRUE if the container is full; otherwise, return FALSE.
T	peek() Return the next element in this IRAContainer withour removing it.
void	put(T input) Add an item to the container.

Method Detail

clear

void clear()

Empty the container. NOTE: This implies a state change. This behavior can be achieved by repeatedly removing elements from this IRAContainer. It is specified here as a convenience to the client.

isFull

boolean isFull()

Return TRUE if the container is full; otherwise, return FALSE.

elements

IList<T> elements(IListFactory<T> fact)

Return an immutable list of all elements in the container.

Parameters:

fact - for manufacturing an IList.

get

T get()

Remove the next item from the container and return it. NOTE: This implies a state change.

put

void put(T input)

Add an item to the container. NOTE: This implies a state change.

Parameters:

input - the Object to be added to this IRAContainer.

peek

T peek()

Return the next element in this IRAContainer withour removing it.

execute

<R,P> R execute(IRACVisitor<T,R,P> v,
                P... inp)

Extensibility hook to accept a visitor algorithm.

Parameters:

v - The visitor to execute

param - An arbitrary input parameter for the visitor

Returns:

The return value of the calculation performed by the visitor.