com.oracle.truffle.api.debug

Class DebugException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.oracle.truffle.api.debug.DebugException

All Implemented Interfaces:

Serializable

public final class DebugException
extends RuntimeException

Information about an exception thrown from a guest language. This exception does not contain a Java stack trace, use DebugException.getDebugStackTrace() to find out the guest language stack trace.

Debugger methods that run guest language code may throw this exception.

Since:

1.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DebugException.CatchLocation Represents an exception catch location.

Method Summary

Modifier and Type	Method and Description
Throwable	fillInStackTrace() Unsupported, DebugException instances are not writable therefore filling the stack trace has no effect for them.
DebugException.CatchLocation	getCatchLocation() Get source code location where this exception is to be caught.
List<DebugStackTraceElement>	getDebugStackTrace() Gets stack trace elements of guest languages.
DebugValue	getExceptionObject() Get a guest language object representing the exception, if any.
StackTraceElement[]	getStackTrace() Gets stack trace elements of guest languages.
SourceSection	getThrowLocation() Get source code location where this exception was thrown from.
boolean	isInternalError() Returns true if this exception indicates an internal error.
void	printStackTrace()
void	printStackTrace(PrintStream s)
void	printStackTrace(PrintWriter s)
void	setStackTrace(StackTraceElement[] stackTrace) Unsupported, DebugException instances are not writable therefore setting the stack trace has no effect for them.

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getMessage, getSuppressed, initCause, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

fillInStackTrace

public Throwable fillInStackTrace()

Unsupported, DebugException instances are not writable therefore filling the stack trace has no effect for them.

Overrides:

fillInStackTrace in class Throwable

Since:

1.0

setStackTrace

public void setStackTrace(StackTraceElement[] stackTrace)

Unsupported, DebugException instances are not writable therefore setting the stack trace has no effect for them.

Overrides:

setStackTrace in class Throwable

Since:

1.0

getStackTrace

public StackTraceElement[] getStackTrace()

Gets stack trace elements of guest languages. It is recommended to use DebugException.getDebugStackTrace() as the guest language stack elements do not always fit the Java format for stack trace elements.

Overrides:

getStackTrace in class Throwable

Since:

1.0

getDebugStackTrace

public List<DebugStackTraceElement> getDebugStackTrace()

Gets stack trace elements of guest languages.

Since:

1.0

printStackTrace

public void printStackTrace()

Overrides:

printStackTrace in class Throwable

Since:

1.0

printStackTrace

public void printStackTrace(PrintStream s)

Overrides:

printStackTrace in class Throwable

Since:

1.0

printStackTrace

public void printStackTrace(PrintWriter s)

Overrides:

printStackTrace in class Throwable

Since:

1.0

isInternalError

public boolean isInternalError()

Returns true if this exception indicates an internal error.

Since:

1.0

getExceptionObject

public DebugValue getExceptionObject()

Get a guest language object representing the exception, if any.

Returns:

an exception object, or null

Since:

1.0

getThrowLocation

public SourceSection getThrowLocation()

Get source code location where this exception was thrown from.

Returns:

the thrown location, or null when the thrown location is not known.

Since:

1.0

getCatchLocation

public DebugException.CatchLocation getCatchLocation()

Get source code location where this exception is to be caught. In case this exception is going to be caught by guest language code, the catch location is provided. null is returned for uncaught exceptions.

Returns:

the catch location, or null in case of uncaught exceptions.

Since:

1.0