CeilingViolationException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - java.lang.RuntimeException
    - - java.lang.IllegalArgumentException
      - java.lang.IllegalThreadStateException
        
        javax.realtime.IllegalTaskStateException
        
        javax.realtime.CeilingViolationException

All Implemented Interfaces:

java.io.Serializable, StaticThrowable<IllegalTaskStateException>
```
public class CeilingViolationException
extends IllegalTaskStateException
```
This exception is thrown when a schedulable or java.lang.Thread attempts to lock an object governed by an instance of PriorityCeilingEmulation and the thread or SO's base priority exceeds the policy's ceiling.

Since:

RTSJ 2.0 implements StaticThrowable

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from interface javax.realtime.StaticThrowable
  StaticThrowable.Hidden

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static CeilingViolationException`	`get()` Obtains the singleton of this static throwable.
`int`	`getCallerPriority()` Gets the base priority of the SO or thread whose attempt to synchronize resulted in the throwing of this.
`int`	`getCeiling()` Gets the ceiling of the `PriorityCeilingEmulation` policy which was exceeded by the base priority of an SO or thread that attempted to synchronize on an object governed by the policy, which resulted in throwing of `this`.
`CeilingViolationException`	`getSingleton()` For the case of legacy code that creates an RTSJ exception explicity, this provides a means of obtaining its singleton version.

Methods inherited from class javax.realtime.IllegalTaskStateException
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Throwable
addSuppressed, getSuppressed, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.realtime.StaticThrowable
init, init, init, init, isStatic, writeReplace

- Method Detail
  - get
```
public static CeilingViolationException get()
```
    Obtains the singleton of this static throwable. It should be initialized before throwing.
    
    Returns:
    
    the single instance of this throwable.
    
    Since:
    
    RTSJ 2.0
  - getCeiling
```
public int getCeiling()
```
    Gets the ceiling of the PriorityCeilingEmulation policy which was exceeded by the base priority of an SO or thread that attempted to synchronize on an object governed by the policy, which resulted in throwing of this.
    
    Returns:
    
    the ceiling of the PriorityCeilingEmulation policy which caused this exception to be thrown.
  - getCallerPriority
```
public int getCallerPriority()
```
    Gets the base priority of the SO or thread whose attempt to synchronize resulted in the throwing of this.
    
    Returns:
    
    the synchronizing thread's base priority.
  - getSingleton
```
public CeilingViolationException getSingleton()
```
    Description copied from interface: StaticThrowable
    
    For the case of legacy code that creates an RTSJ exception explicity, this provides a means of obtaining its singleton version.
    
    Specified by:
    
    getSingleton in interface StaticThrowable<IllegalTaskStateException>
    
    Overrides:
    
    getSingleton in class IllegalTaskStateException
    
    Returns:
    
    the singleton version of this exception.