net.dpml.util
Class EventQueue

java.lang.Object
  net.dpml.util.EventQueue

public class EventQueue

extends Object

A abstract base class that established an event queue and handles event dispatch operations for listeners declared in classes extending this base class.

Version:

1.0.0

Author:

The Digital Product Meta Library

Constructor Summary

EventQueue(Logger logger)
Creation of a new model.

EventQueue(String name)
Creation of a new event queue.

Method Summary

void	enqueueEvent(EventObject event) Enqueue an event for delivery to registered listeners unless there are no registered listeners.
void	enqueueEvent(EventObject event, boolean waitForCompletion) Enqueue an event for delivery to registered listeners unless there are no registered listeners.
void	terminateDispatchThread() Terminate the dispatch thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

EventQueue

public EventQueue(String name)

Creation of a new event queue.

Parameters:

name - the name used to construct a logging channel

EventQueue

public EventQueue(Logger logger)
           throws NullPointerException

Creation of a new model.

Parameters:

logger - the assigned logging channel

Throws:

NullPointerException - if the supplied logging channel is null

Method Detail

terminateDispatchThread

public void terminateDispatchThread()

Terminate the dispatch thread.

enqueueEvent

public void enqueueEvent(EventObject event)

Enqueue an event for delivery to registered listeners unless there are no registered listeners.

Parameters:

event - the event object to add to the queue

enqueueEvent

public void enqueueEvent(EventObject event,
                         boolean waitForCompletion)

Enqueue an event for delivery to registered listeners unless there are no registered listeners.

Parameters:

event - the event object to add to the queue

waitForCompletion - if TRUE the implementation will apply the event to the event source event handler and return on copmpletion of evetn delivery