javax.realtime
Class BoundAsyncEventHandler

java.lang.Object
  |
  +--javax.realtime.AsyncEventHandler
        |
        +--javax.realtime.BoundAsyncEventHandler

All Implemented Interfaces:

java.lang.Runnable, Schedulable

public abstract class BoundAsyncEventHandler

extends AsyncEventHandler

A bound asynchronous event handler is an asynchronous event handler that is permanently bound to a thread. Bound asynchronous event handlers are meant for use in situations where the added timeliness is worth the overhead of binding the handler to a thread.

Constructor Summary

BoundAsyncEventHandler()
Create a handler whose parameters are inherited from the current thread, if it is a RealtimeThread, or null otherwise.

BoundAsyncEventHandler(SchedulingParameters scheduling, ReleaseParameters release, MemoryParameters memory, MemoryArea area, ProcessingGroupParameters group, boolean nonheap, java.lang.Runnable logic)
Create a handler with the specified ReleaseParameters and MemoryParameters.

Methods inherited from class javax.realtime.AsyncEventHandler

addIfFeasible, addToFeasibility, getAndClearPendingFireCount, getAndDecrementPendingFireCount, getAndIncrementPendingFireCount, getMemoryArea, getMemoryParameters, getPendingFireCount, getProcessingGroupParameters, getReleaseParameters, getScheduler, getSchedulingParameters, handleAsyncEvent, removeFromFeasibility, run, setIfFeasible, setIfFeasible, setIfFeasible, setMemoryParameters, setMemoryParametersIfFeasible, setProcessingGroupParameters, setProcessingGroupParametersIfFeasible, setReleaseParameters, setReleaseParametersIfFeasible, setScheduler, setScheduler, setSchedulingParameters, setSchedulingParametersIfFeasible

Methods inherited from class java.lang.Object

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

Constructor Detail

BoundAsyncEventHandler

public BoundAsyncEventHandler()

Create a handler whose parameters are inherited from the current thread, if it is a RealtimeThread, or null otherwise.

BoundAsyncEventHandler

public BoundAsyncEventHandler(SchedulingParameters scheduling,
                              ReleaseParameters release,
                              MemoryParameters memory,
                              MemoryArea area,
                              ProcessingGroupParameters group,
                              boolean nonheap,
                              java.lang.Runnable logic)

Create a handler with the specified ReleaseParameters and MemoryParameters.

Parameters:

scheduling - A SchedulingParameters object which will be associated with the constructed instance of this. If null this will be assigned the reference to the SchedulingParameters of the current thread.

release - The ReleaseParameters object for this. A value of null will construct this without a ReleaseParameters object.

memory - The MemoryParameters object for this. A value of null will construct this without a MemoryParameters object.

area - The MemoryArea for this BoundAsyncEventHandler. If null, inherit the current memory area at the time of construction. The initial memory area must be a reference to a ScopedMemory or ImmortalMemory object if noheap is true.

nonheap - A flag meaning, when true, that this will have characteristics identical to a NoHeapRealtimeThread.

group - A ProcessingGroupParameters object to which this will be associated. If null this will not be associated with any processing group.

logic - The Runnable object whose run is executed by handleAsyncEvent.

Throws:

{@link - IllegalArgumentException} if the initial memory area is in heap memory, and the noheap parameter is true.