javax.realtime
Class ActiveEventDispatcher<T>

java.lang.Object
  javax.realtime.ActiveEventDispatcher<T>

Type Parameters:

T - is the type of ActiveEvent that this class dispatches.

public abstract class ActiveEventDispatcher<T>
extends Object

Provides a means of dispatching a set of ActiveEvents. It acts as if it contains a RealtimeThread to perform this task. The priority of this thread can be specified when a dispatcher object is created. The default dispatcher runs at the highest Java realtime priority.

Application code should not extend this class.

Constructor Summary

protected

ActiveEventDispatcher(SchedulingParameters schedule) Create a new dispatcher.

Method Summary

abstract void	deregister(T event) Deregister a POSIX Signal form this dispatcher.
abstract void	destroy() Makes the dispatcher unusable.
abstract void	register(T event) Register a POSIX signal with this dispatcher.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActiveEventDispatcher

protected ActiveEventDispatcher(SchedulingParameters schedule)

Create a new dispatcher.

Parameters:

schedule - provide scheduling informs to the new object.

Method Detail

register

public abstract void register(T event)
                       throws RegistrationException,
                              IllegalStateException,
                              IllegalArgumentException

Register a POSIX signal with this dispatcher.

Parameters:

event - to register

Throws:

RegistrationException - when event is already registered.

IllegalStateException - when this object has been destroyed.

IllegalArgumentException - when event is not stopped.

deregister

public abstract void deregister(T event)
                         throws DeregistrationException,
                                IllegalStateException,
                                IllegalArgumentException

Deregister a POSIX Signal form this dispatcher. (This is a really naive implementation.)

Parameters:

event - to deregister

Throws:

DeregistrationException - when event is already registered.

IllegalStateException - when this object has been destroyed.

IllegalArgumentException - when event is not stopped.

destroy

public abstract void destroy()
                      throws IllegalStateException

Makes the dispatcher unusable.

Throws:

IllegalStateException - when called on a dispatcher that has one or more registered objects.