javax.realtime

Class AsyncLongEvent

java.lang.Object

javax.realtime.AsyncBaseEvent

javax.realtime.AsyncLongEvent

Direct Known Subclasses:

RealtimeSignal

public class AsyncLongEvent
extends AsyncBaseEvent

An event that carries a long as 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.

• When the instance of AsyncLongEvent is associated with more than one instance of AsyncLongEventHandler with release parameters object of type AperiodicParameters and the execution of fire(long) introduces the requirement to throw at least one type of exception, then all instances of AsyncLongEventHandler not affected by the exception are handled normally.
• When this instance of AsyncLongEvent is associated with more than one instance of AsyncLongEventHandler with release parameters object of type SporadicParameters and the execution of fire(long) introduces the simultaneous requirement to throw more than one type of exception or error, then MITViolationException has precedence over ArrivalTimeQueueOverflowException.

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.

StaticUnsupportedOperationException - when used with an AsyncObjectEventHandler, since that class is not yet implemented.

Parameters:

value - The payload passed to the event.