javax.realtime.posix

Class SignalDispatcher

java.lang.Object

javax.realtime.ActiveEventDispatcher<SignalDispatcher,Signal>

javax.realtime.posix.SignalDispatcher

public class SignalDispatcher
extends ActiveEventDispatcher<SignalDispatcher,Signal>

Provides a means of dispatching a set of Signals. An application can provide its own dispatcher, providing the priority for the internal dispatching thread. This dispatching thread calls process() each time the signal is triggered.

Since:

RTSJ 2.0

Constructor Summary

Constructors

Constructor and Description
SignalDispatcher(SchedulingParameters scheduling) Creates a new dispatcher, whose dispatching thread runs with the given SchedulingParameters.
SignalDispatcher(SchedulingParameters scheduling, RealtimeThreadGroup group) Creates a new dispatcher, whose dispatching thread runs with the given SchedulingParameters.

Method Summary

Modifier and Type	Method and Description
void	deregister(Signal signal) Deregisters the POSIX Signal from this dispatcher.
void	destroy() Releases all reasources thereby making the dispatcher unusable.
void	register(Signal signal) Registers a POSIX signal with this dispatcher.
static void	setDefaultDispatcher(SignalDispatcher dispatcher) Sets the system default signal dispatcher.

Methods inherited from class javax.realtime.ActiveEventDispatcher

getRealtimeThreadGroup, getScheduler, getSchedulingParameters, setScheduler, setScheduler, setSchedulingParameters

Methods inherited from class java.lang.Object

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

Constructor Detail

SignalDispatcher

public SignalDispatcher(SchedulingParameters scheduling,
                        RealtimeThreadGroup group)

Creates a new dispatcher, whose dispatching thread runs with the given SchedulingParameters.

Parameters:

scheduling - Parameters for scheduling this dispatcher.

group - Container for this dispatcher.

Throws:

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.

SignalDispatcher

public SignalDispatcher(SchedulingParameters scheduling)

Creates a new dispatcher, whose dispatching thread runs with the given SchedulingParameters.

Parameters:

scheduling - For scheduling this dispatcher.

Throws:

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.

Method Detail

setDefaultDispatcher

public static void setDefaultDispatcher(SignalDispatcher dispatcher)

Sets the system default signal dispatcher.

Parameters:

dispatcher - An instance to be used when no dispatcher is provided. When null, the signal dispatcher is set to the original system default.

Throws:

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.

register

public void register(Signal signal)
              throws RegistrationException,
                     StaticIllegalStateException,
                     StaticIllegalArgumentException

Registers a POSIX signal with this dispatcher.

Specified by:

register in class ActiveEventDispatcher<SignalDispatcher,Signal>

Parameters:

signal - The signal instance to register.

Throws:

RegistrationException - when Signal is already registered.

StaticIllegalStateException - when this object has been destroyed.

StaticIllegalArgumentException - when Signal is not stopped.

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.

deregister

public void deregister(Signal signal)
                throws DeregistrationException,
                       StaticIllegalStateException,
                       StaticIllegalArgumentException

Deregisters the POSIX Signal from this dispatcher.

Specified by:

deregister in class ActiveEventDispatcher<SignalDispatcher,Signal>

Parameters:

signal - The signal instance to deregister.

Throws:

DeregistrationException - when Signal is not already registered.

StaticIllegalStateException - when this object has been destroyed.

StaticIllegalArgumentException - when Signal is not stopped.

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.

destroy

public void destroy()
             throws StaticIllegalStateException

Releases all reasources thereby making the dispatcher unusable.

Specified by:

destroy in class ActiveEventDispatcher<SignalDispatcher,Signal>

Throws:

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

java.lang.UnsupportedOperationException - everytime, since this is not implemented yet.