javax.realtime

Class ReleaseRunner

java.lang.Object

javax.realtime.ReleaseRunner

Direct Known Subclasses:

BlockableReleaseRunner

public abstract class ReleaseRunner
extends Object

Manages a pool of threads to execute asynchronous event handler releases. The implementer is responsible for maintaining the pool of threads and ensuring they all have at least the desired ConfigurationParameters, RealtimeThreadGroup, and Affinity.

The other parameters for instances of Schedulable can either be set for each release or be configurable for the pool. In the latter case, one should not be able to associate a handler with the runner that has an incompatible parameter set. These other parameters are SchedulingParameters, ReleaseParameters, and MemoryParameters, as well as the MemoryArea in which the release should take place.

The default release runner, BlockableReleaseRunner, sets these other parameters on the releasing thread at each release. Since there may be a performance penalty for doing this, an application can define its own release runners for commonly occurring cases of these parameters. It is then up to the application to ensure that handlers are matched to the correct release runner.

Since:

RTSJ 2.0

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ReleaseRunner(RealtimeThreadGroup group) Enables creating a subclass of this class.

Method Summary

Modifier and Type	Method and Description
protected abstract void	attach(AsyncBaseEventHandler handler) Notifies this runner that the handler is now associated with it.
protected abstract void	detach(AsyncBaseEventHandler handler) Notifies this runner that the handler is no longer associated with it.
abstract ConfigurationParameters	getConfigurationParameters() Get the ConfigurationParameters object used for all threads provided by this release runner.
protected RealtimeThreadGroup	getRealtimeThreadGroup() Determine the RealtimeThreadGroup instance used.
protected abstract void	release(AsyncBaseEventHandler handler) Finds a thread and has it call the Runnable.run() method.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReleaseRunner

protected ReleaseRunner(RealtimeThreadGroup group)

Enables creating a subclass of this class.

Method Detail

getRealtimeThreadGroup

protected RealtimeThreadGroup getRealtimeThreadGroup()

Determine the RealtimeThreadGroup instance used.

Returns:

the RealtimeThreadGroup instance used by all threads used for running releases.

getConfigurationParameters

public abstract ConfigurationParameters getConfigurationParameters()

Get the ConfigurationParameters object used for all threads provided by this release runner.

Returns:

those parameters.

release

protected abstract void release(AsyncBaseEventHandler handler)

Finds a thread and has it call the Runnable.run() method. Care should be exercised when implementing this method, since it adds to both the latency and jitter of releasing events.

This method should only be called from the infrastructure.

Parameters:

handler - The handler to be released.

attach

protected abstract void attach(AsyncBaseEventHandler handler)
                        throws StaticIllegalStateException

Notifies this runner that the handler is now associated with it.

This method should only be called from the infrastructure.

Throws:

StaticIllegalStateException - when handler is already attached.

Parameters:

handler - The handler to be attached

detach

protected abstract void detach(AsyncBaseEventHandler handler)
                        throws StaticIllegalStateException

Notifies this runner that the handler is no longer associated with it.

This method should only be called from the infrastructure.

Throws:

StaticIllegalStateException - when handler is not attached.

Parameters:

handler - The handler to be removed