javax.realtime

Class MemoryAccessError

java.lang.Object

java.lang.Throwable

java.lang.Error

javax.realtime.StaticError

javax.realtime.MemoryAccessError

All Implemented Interfaces:

Serializable, StaticThrowable<MemoryAccessError>

public class MemoryAccessError
extends StaticError
implements StaticThrowable<MemoryAccessError>

This error is thrown on an attempt to refer to an object in an inaccessible MemoryArea. For example, when logic in a RealtimeThread or AsyncBaseEventHandler configured with a javax.realtime.memory.ScopedConfigurationParameters object, attempts to refer to an object in a HeapMemory area.

Since:

RTSJ 2.0 extends StaticError

See Also:

Serialized Form

Nested Class Summary

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

StaticThrowable.Hidden

Constructor Summary

Constructors

Constructor and Description
MemoryAccessError() Deprecated. in RTSJ 2.0
MemoryAccessError(String description) Deprecated. since RTSJ 2.0; application code should use get() instead.

Method Summary

Modifier and Type	Method and Description
static MemoryAccessError	get() Gets the preallocated version of this Throwable.
MemoryAccessError	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, isStatic, printStackTrace, printStackTrace, printStackTrace, setStackTrace, writeReplace

Constructor Detail

MemoryAccessError

@Deprecated
public MemoryAccessError()

Deprecated. in RTSJ 2.0

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

MemoryAccessError

@Deprecated
public MemoryAccessError(String description)

Deprecated. since RTSJ 2.0; application code should use get() instead.

A descriptive constructor for MemoryAccessError.

Parameters:

description - The reason for throwing this error.

Method Detail

get

public static MemoryAccessError 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 MemoryAccessError 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<MemoryAccessError>

Specified by:

getSingleton in class StaticError

Returns:

the singleton version of this exception.