javax.realtime

Class IllegalAssignmentError

java.lang.Object

java.lang.Throwable

java.lang.Error

javax.realtime.StaticError

javax.realtime.IllegalAssignmentError

All Implemented Interfaces:

Serializable, StaticThrowable<IllegalAssignmentError>

public class IllegalAssignmentError
extends StaticError
implements StaticThrowable<IllegalAssignmentError>

Jamaica Real-Time Specification for Java class IllegalAssignmentError.

This exception will be thrown whenever an assignment of a reference value to an object is made and the target object is not allowed to refer to the assigned object. This is the case if the assigned reference was allocated in ScopedMemory and the target object is not ScopedMemory or is not the same scope or an inner scope of the assigned reference's scope.

Since:

RTSJ 2.0 implements StaticThrowable

See Also:

Serialized Form

Nested Class Summary

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

StaticThrowable.Hidden

Constructor Summary

Constructors

Constructor and Description
IllegalAssignmentError() Deprecated. RTSJ 2.0: replaced by IllegalAssignmentError.get().init()
IllegalAssignmentError(String description) Deprecated. RTSJ 2.0; replaced by IllegalAssignmentError.get().init(description)

Method Summary

Modifier and Type	Method and Description
static IllegalAssignmentError	get() Gets the preallocated version of this Throwable.
IllegalAssignmentError	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

IllegalAssignmentError

public IllegalAssignmentError()

Deprecated. RTSJ 2.0: replaced by IllegalAssignmentError.get().init()

Constructor of this exception without detail message.

IllegalAssignmentError

public IllegalAssignmentError(String description)

Deprecated. RTSJ 2.0; replaced by IllegalAssignmentError.get().init(description)

Constructor of this exception with detail message.

Parameters:

description - The detail message or null if none.

Method Detail

get

public static IllegalAssignmentError get()

Gets the preallocated version of this Throwable. Allocation is done in memory that acts like ImmortalMemory. The message and cause are cleared and the stack trace is filled out.

Returns:

the preallocated exception.

getSingleton

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

Returns:

the singleton version of this exception.