javax.realtime

Class AsyncLongEvent

java.lang.Object

javax.realtime.AsyncBaseEvent

javax.realtime.AsyncLongEvent

Direct Known Subclasses:

RealtimeSignal

public class AsyncLongEvent
extends AsyncBaseEvent

A new type of event that carries a long as a payload.

Since:

RTSJ 2.0

See Also:

AsyncEvent

Constructor Summary

Constructors

Constructor and Description
AsyncLongEvent() Creates a new AsyncLongEvent object.

Method Summary

Modifier and Type	Method and Description
void	fire(long value) When enabled, releases the handlers associated with this instance of AsyncLongEvent with the long passed by fire(long).

Methods inherited from class javax.realtime.AsyncBaseEvent

addHandler, createReleaseParameters, disable, enable, handledBy, hasHandlers, isRunning, removeHandler, setHandler

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncLongEvent

public AsyncLongEvent()

Creates a new AsyncLongEvent object.

Method Detail

fire

public void fire(long value)
          throws MITViolationException,
                 EventQueueOverflowException

When enabled, releases the handlers associated with this instance of AsyncLongEvent with the long passed by fire(long). When no handlers are attached or this object is disabled the method does nothing, i.e., it skips the release. For an instance of AsyncEvent that has more than one instance of AsyncEventHandler,

• when one of these handlers throws an exception, all instances of AsyncEventHandler not affected by the exception must be released normally before the exception is propagated, and
• when more than one of these handlers throws an exception, the propagation of MITViolationException has precedence over ArrivalTimeQueueOverflowException, which has precedence over all others.

The later case can only occur when more than one of the handlers has a release parameters instance of type SporadicParameters, since only them can MITViolationException and ArrivalTimeQueueOverflowException be thrown.

Parameters:

value - The payload passed to the event.

Throws:

MITViolationException - under the base priority scheduler's semantics, when there is a handler associated with this event that has its MIT violated by the call to fire (and it has set the minimum inter-arrival time violation behavior to MITViolationExcept). Only the handlers which do not have their MITs violated are released in this situation.

EventQueueOverflowException - when the queue of release information, arrival time and payload, overflows. Only the handlers which do not cause this exception to be thrown are released in this situation. When fire is called from the infrastructure, such as for an ActiveEvent, this exception is ignored.