javax.realtime

Class ThrowBoundaryError

java.lang.Object

java.lang.Throwable

java.lang.Error

javax.realtime.StaticError

javax.realtime.ThrowBoundaryError

All Implemented Interfaces:

Serializable, StaticThrowable<ThrowBoundaryError>

public class ThrowBoundaryError
extends StaticError
implements StaticThrowable<ThrowBoundaryError>

Jamaica Real-Time Specification for Java class ThrowBoundaryError.

This exception is thrown by MemoryArea.enter when the logic performed within the MemoryArea returned by throwing an exception and this exception is allocated in a memory area that is no more accessible after returning from enter.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface javax.realtime.StaticThrowable

StaticThrowable.Hidden

Constructor Summary

Constructors

Constructor and Description
ThrowBoundaryError() A constructor for ThrowBoundaryError, but application code should use get() instead.
ThrowBoundaryError(String description) A descriptive constructor for ThrowBoundaryError.

Method Summary

Modifier and Type	Method and Description
static ThrowBoundaryError	get() Gets the preallocated instance of this exception.
static ThrowBoundaryError	get(Throwable cause) Gets the preallocated instance of this exception and set the message and backtrace from cause and set cause to cause as well.
ThrowBoundaryError	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.StaticError

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

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, init, init, init, init, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, writeReplace

Constructor Detail

ThrowBoundaryError

public ThrowBoundaryError()

A constructor for ThrowBoundaryError, but application code should use get() instead.

ThrowBoundaryError

public ThrowBoundaryError(String description)

A descriptive constructor for ThrowBoundaryError.

Parameters:

description - The reason for throwing this error.

Method Detail

get

public static ThrowBoundaryError get()

Gets the preallocated instance of this exception.

Returns:

the preallocated instance of this exception.

get

public static ThrowBoundaryError get(Throwable cause)

Gets the preallocated instance of this exception and set the message and backtrace from cause and set cause to cause as well.

Parameters:

cause - The throwable that cause the scope boundary error.

Returns:

the preallocated instance of this exception.

getSingleton

public ThrowBoundaryError 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<ThrowBoundaryError>

Returns:

the singleton version of this exception.