javax.realtime

Class StaticIllegalArgumentException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalArgumentException

javax.realtime.StaticIllegalArgumentException

All Implemented Interfaces:

java.io.Serializable, StaticThrowable<StaticIllegalArgumentException>

public class StaticIllegalArgumentException
extends java.lang.IllegalArgumentException
implements StaticThrowable<StaticIllegalArgumentException>

A version of IllegalArgumentException to be thrown by RTSJ methods that does not require allocation.

Since:

RTSJ 2.0

See Also:

Serialized Form

Nested Class Summary

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

StaticThrowable.Hidden

Method Summary

Modifier and Type	Method and Description
java.lang.Throwable	fillInStackTrace() Calls into the virtual machine to capture the current stack trace in the instance of StaticThrowableStorage associated with this task.
static StaticIllegalArgumentException	get() Gets the preallocated version of this Throwable.
java.lang.Throwable	getCause() Gets the cause from thread local memory of the calling exception or null when no cause was set.
java.lang.String	getLocalizedMessage() Subclasses may override this message to get an error message that is localized to the default locale.
java.lang.String	getMessage() Gets the message describing the exception's cause from thread local memory.
StaticIllegalArgumentException	getSingleton() For the case of legacy code that creates an RTSJ exception explicity, this provides a means of obtaining its singleton version.
java.lang.StackTraceElement[]	getStackTrace() Gets the stack trace created by fillInStackTrace for this Throwable from the current thread local storage as an array of StackTraceElements.
java.lang.Throwable	initCause(java.lang.Throwable causingThrowable) Store the cause of calling exception in the instance of StaticThrowableStorage associated with this task.
void	printStackTrace() Prints stack trace of this Throwable to System.err.
void	printStackTrace(java.io.PrintStream stream) Prints the stack trace of this Throwable to the given stream.
void	printStackTrace(java.io.PrintWriter writer) Prints the stack trace of this Throwable to the given PrintWriter.
void	setStackTrace(java.lang.StackTraceElement[] trace) This method enables overriding the stack trace that was filled during construction of this object.

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 StaticIllegalArgumentException get()

Gets the preallocated version of this Throwable. Allocation is done in memory that acts like ImmortalMemory. The message, cause, and the stack are cleared. It should be initialized before throwing.

Returns:

the preallocated exception.

getMessage

public java.lang.String getMessage()

Description copied from interface: StaticThrowable

Gets the message describing the exception's cause from thread local memory.

Specified by:

getMessage in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

getMessage in class java.lang.Throwable

Returns:

the message when this was the last method thrown and message was set for it or null.

getLocalizedMessage

public java.lang.String getLocalizedMessage()

Description copied from interface: StaticThrowable

Subclasses may override this message to get an error message that is localized to the default locale.

By default it returns getMessage().

Specified by:

getLocalizedMessage in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

getLocalizedMessage in class java.lang.Throwable

Returns:

the value of getMessage().

initCause

public java.lang.Throwable initCause(java.lang.Throwable causingThrowable)

Description copied from interface: StaticThrowable

Store the cause of calling exception in the instance of StaticThrowableStorage associated with this task.

Specified by:

initCause in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

initCause in class java.lang.Throwable

Parameters:

causingThrowable - The reason why this Throwable gets thrown.

Returns:

the reference to this Throwable.

getCause

public java.lang.Throwable getCause()

Description copied from interface: StaticThrowable

Gets the cause from thread local memory of the calling exception or null when no cause was set. The cause is another exception that was caught before the current exception is to be thrown.

Specified by:

getCause in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

getCause in class java.lang.Throwable

Returns:

the cause when this was the last thrown exception and cause was set or null.

fillInStackTrace

public java.lang.Throwable fillInStackTrace()

Description copied from interface: StaticThrowable

Calls into the virtual machine to capture the current stack trace in the instance of StaticThrowableStorage associated with this task.

Specified by:

fillInStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

fillInStackTrace in class java.lang.Throwable

Returns:

a reference to this Throwable.

setStackTrace

public void setStackTrace(java.lang.StackTraceElement[] trace)
                   throws java.lang.NullPointerException

Description copied from interface: StaticThrowable

This method enables overriding the stack trace that was filled during construction of this object. It is intended to be used in a serialization context when the stack trace of a remote exception should be treated like a local.

Specified by:

setStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

setStackTrace in class java.lang.Throwable

Parameters:

trace - the stack trace to be used as replace.

Throws:

java.lang.NullPointerException - when new_stackTrace or any element of new_stackTrace is null.

getStackTrace

public java.lang.StackTraceElement[] getStackTrace()

Description copied from interface: StaticThrowable

Gets the stack trace created by fillInStackTrace for this Throwable from the current thread local storage as an array of StackTraceElements.

The stack trace does not need to contain entries for all methods that are actually on the call stack, the virtual machine may decide to skip some stack trace entries. Even an empty array is a valid result of this function.

Repeated calls of this function without intervening calls to fillInStackTrace will return the same result.

When memory areas of the RTSJ are used (see MemoryArea), and this Throwable was allocated in a different memory area than the current allocation context, the resulting stack trace will be allocated in either the same memory area this was allocated in or the current memory area, depending on which is the least deeply nested, thereby creating objects that are assignment compatible with both areas.

Specified by:

getStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

getStackTrace in class java.lang.Throwable

Returns:

An array representing the stack trace when this was the last message thrown or an empty trace array, but never null.

printStackTrace

public void printStackTrace()

Description copied from interface: StaticThrowable

Prints stack trace of this Throwable to System.err.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number when available.

Specified by:

printStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream stream)

Description copied from interface: StaticThrowable

Prints the stack trace of this Throwable to the given stream.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number when available.

Specified by:

printStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

stream - The stream to print to.

printStackTrace

public void printStackTrace(java.io.PrintWriter writer)

Description copied from interface: StaticThrowable

Prints the stack trace of this Throwable to the given PrintWriter.

The printed stack trace contains the result of toString() as the first line followed by one line for each stack trace element that contains the name of the method or constructor, optionally followed by the source file name and source file line number when available.

Specified by:

printStackTrace in interface StaticThrowable<StaticIllegalArgumentException>

Overrides:

printStackTrace in class java.lang.Throwable

Parameters:

writer - The PrintWriter to write to.

getSingleton

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

Returns:

the singleton version of this exception.