javax.realtime

Class BackgroundParameters

java.lang.Object

javax.realtime.ReleaseParameters<BackgroundParameters>

javax.realtime.BackgroundParameters

All Implemented Interfaces:

Serializable, Cloneable

public class BackgroundParameters
extends ReleaseParameters<BackgroundParameters>

Parameters for realtime threads that are only released once. A thread using this release parameters may not use RealtimeThread.waitForNextRelease() or have its RealtimeThread.release() methods called. Calling these methods results in an IllegalThreadStateException. Event handlers may not use this type of ReleaseParameters.

Since:

RTSJ 2.0

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.realtime.ReleaseParameters

DISABLE_MONITORING

Constructor Summary

Constructors

Constructor and Description
BackgroundParameters() A constructor for not having any restrictions on, or monitoring of, scheduling.
BackgroundParameters(RelativeTime deadline, AsyncEventHandler missHandler) A constructor for deadline monitoring.
BackgroundParameters(RelativeTime cost, RelativeTime deadline, AsyncEventHandler overrunHandler, AsyncEventHandler missHandler) A constructor for both cost and deadline monitoring.

Method Summary

Methods inherited from class javax.realtime.ReleaseParameters

clone, getCost, getCost, getCostOverrunHandler, getDeadline, getDeadline, getDeadlineMissHandler, getEventQueueOverflowPolicy, getInitialQueueLength, isRousable, setCost, setCostOverrunHandler, setDeadline, setDeadlineMissHandler, setEventQueueOverflowPolicy, setIfFeasible, setInitialQueueLength, setRousable

Methods inherited from class java.lang.Object

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

Constructor Detail

BackgroundParameters

public BackgroundParameters(RelativeTime cost,
                            RelativeTime deadline,
                            AsyncEventHandler overrunHandler,
                            AsyncEventHandler missHandler)

A constructor for both cost and deadline monitoring.

Throws:

StaticIllegalArgumentException - when the time value of cost is less than zero, or the time value of deadline is less than or equal to zero, or the chronograph associated with the cost or deadline parameters is not an instance of Clock.

IllegalAssignmentError - when cost, deadline, overrunHandler, or missHandler cannot be stored in this.

Parameters:

cost - The maximum cost for executing the run method

deadline - The deadline for the completion of the run method

overrunHandler - The handler to call on cost overrun.

missHandler - The handler to call on deadline miss.

BackgroundParameters

public BackgroundParameters(RelativeTime deadline,
                            AsyncEventHandler missHandler)

A constructor for deadline monitoring. Equivalent to BackgroundParameters(null, deadline, null, missHandler)

BackgroundParameters

public BackgroundParameters()

A constructor for not having any restrictions on, or monitoring of, scheduling. Equivalent to BackgroundParameters(null, null, null, null, false)