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 java.lang.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

Constructors

Modifier	Constructor and Description
protected	ActiveEventDispatcher(SchedulingParameters schedule) Create a new dispatcher.

Method Summary

Modifier and Type	Method and Description
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,
                              java.lang.IllegalStateException,
                              java.lang.IllegalArgumentException

Register a POSIX signal with this dispatcher.

Parameters:

event - to register

Throws:

RegistrationException - when event is already registered.

java.lang.IllegalStateException - when this object has been destroyed.

java.lang.IllegalArgumentException - when event is not stopped.

deregister

public abstract void deregister(T event)
                         throws DeregistrationException,
                                java.lang.IllegalStateException,
                                java.lang.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.

java.lang.IllegalStateException - when this object has been destroyed.

java.lang.IllegalArgumentException - when event is not stopped.

destroy

public abstract void destroy()
                      throws java.lang.IllegalStateException

Makes the dispatcher unusable.

Throws:

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