javax.realtime
Class PriorityCeilingEmulation

java.lang.Object
  javax.realtime.MonitorControl
      javax.realtime.PriorityCeilingEmulation

public class PriorityCeilingEmulation

extends MonitorControl

A monitor control class specifying the priority ceiling protocol as a strategy to avoid deadlock.

Since:

0.3.8

Author:

Morgan Deters

See Also:

MonitorControl, PriorityInheritance

Method Summary

int	getCeiling() Returns the ceiling priority for this PriorityCeilingEmulation object.
int	getDefaultCeiling() Deprecated. This method is deprecated in version 1.0.1(b) of the RTSJ because its name is misleading; replaced with getCeiling().
static PriorityCeilingEmulation	getMaxCeiling() Gets an instance of PriorityCeilingEmulation that describes a priority ceiling monitor control policy with a ceiling of PriorityScheduler.instance().getMaxPriority().
static PriorityCeilingEmulation	instance(int ceiling) Return a PriorityCeilingEmulation object with the specified ceiling.

Methods inherited from class javax.realtime.MonitorControl

getMonitorControl, getMonitorControl, setMonitorControl, setMonitorControl

Methods inherited from class java.lang.Object

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

Method Detail

getDefaultCeiling

public int getDefaultCeiling()

Deprecated. This method is deprecated in version 1.0.1(b) of the RTSJ because its name is misleading; replaced with getCeiling().

Returns the ceiling priority for this PriorityCeilingEmulation object.

Returns:

the ceiling priority for this PriorityCeilingEmulation object

getCeiling

public int getCeiling()

Returns the ceiling priority for this PriorityCeilingEmulation object.

Returns:

the ceiling priority for this PriorityCeilingEmulation object

getMaxCeiling

public static PriorityCeilingEmulation getMaxCeiling()

Gets an instance of PriorityCeilingEmulation that describes a priority ceiling monitor control policy with a ceiling of PriorityScheduler.instance().getMaxPriority(). The returned object is allocated in immortal memory and is the same across all invocations of this method.

Returns:

a PriorityCeilingEmulation object describing a priority ceiling monitor control policy with the highest ceiling possible

instance

public static PriorityCeilingEmulation instance(int ceiling)

Return a PriorityCeilingEmulation object with the specified ceiling. This object is allocated in ImmortalMemory. All invocations of this method with a given ceiling value return a reference to the same object.

Parameters:

ceiling - the ceiling value for which to get a PriorityCeilingEmulation

Returns:

a PriorityCeilingEmulation describing a priority ceiling monitor control policy with the given ceiling

Throws:

IllegalArgumentException - if ceiling is outside the valid range