javax.realtime
Class BoundAsyncEventHandler

java.lang.Object
  javax.realtime.AsyncEventHandler
      javax.realtime.BoundAsyncEventHandler

All Implemented Interfaces:

java.lang.Runnable, Schedulable

public class BoundAsyncEventHandler
extends AsyncEventHandler

A bound asynchronous event handler is an instance of AsyncEventHandler that is permanently bound to a dedicated real-time thread. Bound asynchronous event handlers are for use in situations where the added timeliness is worth the overhead of dedicating an individual real-time thread to the handler. Individual server real-time threads can only be dedicated to a single bound event handler.

BoundAsyncEventHandler

public BoundAsyncEventHandler()

Create an instance of BoundAsyncEventHandler using default values. This constructor is equivalent to BoundAsyncEventHandler(null, null, null, null, null, false, null)

BoundAsyncEventHandler

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

Create an instance of BoundAsyncEventHandler with the specified parameters.

Parameters:

scheduling - A SchedulingParameters object which will be associated with the constructed instance. If null, and the creator is a Java thread, a SchedulingParameters object is created which has the default SchedulingParameters for the scheduler associated with the current thread. If null, and the creator is a schedulable object, the SchedulingParameters are inherited from the current schedulable object (a new SchedulingParameters object is cloned).

release - A ReleaseParameters object which will be associated with the constructed instance. If null, this will have default ReleaseParameters for the BAEH's scheduler.

memory - A MemoryParameters object which will be associated with the constructed instance. If null, this will have no MemoryParameters.

area - The MemoryArea for this. If null, the memory area will be that of the current thread/schedulable object.

group - A ProcessingGroupParameters object which will be associated with the constructed instance. If null, this will not be associated with any processing group.

logic - The Runnable object whose run() method is executed by AsyncEventHandler.handleAsyncEvent(). If null, the default AsyncEventHandler.handleAsyncEvent() method invokes nothing.

nonheap - A flag meaning, when true, that this will have characteristics identical to a NoHeapRealtimeThread. A false value means this will have characteristics identical to a RealtimeThread. If true and the current thread/schedulable object is not executing within a ScopedMemory or ImmortalMemory scope then an IllegalArgumentException is thrown.

Throws:

java.lang.IllegalArgumentException - Thrown if nonheap is true and logic, any parameter object, or this is in heap memory. Also thrown if noheap is true and area is heap memory.

IllegalAssignmentError - Thrown if the new AsyncEventHandler instance cannot hold a reference to non-null values of scheduling release memory and group, or if those parameters cannot hold a reference to the new AsyncEventHandler. Also thrown if the new AsyncEventHandler instance cannot hold a reference to non-null values of area and logic.