Package com.glaivestone.javax.util

Extensions to the standard Java java.util package.

See:
Description

Interface Summary

Association	This interface represents a key-value pair.
AssociationIterator	This interface is an Iterator over Association objects (key-value pairs).
AssociationList	This interface represents a list of Association objects (key-value pairs).

Class Summary

AssociationArrayList	This class implements AssociationList to provide a list of Association objects (key-value pairs).
AssociationItr	The Iterator used by AssociationArrayList.
BasicAssociation	This class implements Association to represent a key-value pair.
ConfirmationEventObject	A ConfirmationEventObject is used for confirmation event notifications representing a proposal which can be vetoed by a listener.
EventListenerList	An EventListenerList holds a homogeneous list of event listeners.
EventManager	An EventManager manages event listener lists for one or more types of events.
Itr	An Iterator used for List objects.
MapX	General-purpose extensions to the standard Map services.
Numbers	Extensions to the standard numeric services.
StatusValue	A multi-state status value.

Exception Summary

PropagatedException	An unchecked exception that is used to propagate an underlying exception into a containing context.
VetoException	A VetoException is thrown to indicate disagreement with a proposal.

Package com.glaivestone.javax.util Description

Extensions to the standard Java java.util package.

Various convenience services and extensions for working with basic data value classes and collections.

Data Values and Collections

The MapX and Numbers classes provide miscellaneous static convenience services for working with maps (key-value table collections) and numbers.

The Association interface and related facilities standardizes the notion of a key-value pair, frequently used in collections such as lists and mapping tables. Itr provides a base class to simplify implementations of custom iterators for Java 2 collections.

Event Support

The EventManager is an implementation framework for classes which support one or more event interfaces. The event table of an event manager provides a standard storage mechanism for the handlers (listeners) registered on the event source object to listen for event notifications. EventListenerList is a standard support class for managing a list of event listeners - it is used by EventManager.

ConfirmationEventObject and VetoException provide a standard approach for implementing confirmation events. In designing events, consider the following convention:

• confirmation event - veto-able event notification that something is about to happen
• notification event - notification that something is about to or has just happened