com.oracle.truffle.espresso.polyglot

Class ForeignException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.oracle.truffle.espresso.polyglot.ForeignException

All Implemented Interfaces:

Serializable

public final class ForeignException
extends RuntimeException

Handy wrapper for foreign exceptions.

Allows foreign exceptions to be caught in guest Java and provides seamless access to the message, cause and a polyglot stacktrace containing all guest frames if any. ForeignException can only catch and wrap foreign exceptions.

 assert Interop.isException(foreignException);
 try {
     throw Interop.throwException(foreignException);
 } catch (ForeignException e) {
     log(e.getClass() + ": " + e.getMessage());
     ...
     throw e;
 }
 

The raw foreign exception object which can serve polyglot messages e.g. InteropLibrary#isException(rawForeignException) can be retrieved with ForeignException.getForeignExceptionObject().

Since:

21.0

See Also:

Interop.throwException(Object), Serialized Form

Method Summary

Modifier and Type	Method and Description
Throwable	fillInStackTrace()
Throwable	getCause()
Object	getForeignExceptionObject() Returns the original wrapped foreign exception.
String	getMessage()
Throwable	initCause(Throwable cause)
void	setStackTrace(StackTraceElement[] stackTrace) Unsupported, ForeignException instances are by definition foreign and thus stacktraces should not be controllable by the guest.

Methods inherited from class java.lang.Throwable

addSuppressed, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

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

Method Detail

getForeignExceptionObject

public Object getForeignExceptionObject()

Returns the original wrapped foreign exception. The returned instance should be used for Interop messages.

Returns:

the wrapped foreign exception.

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getCause

public Throwable getCause()

Overrides:

getCause in class Throwable

setStackTrace

public void setStackTrace(StackTraceElement[] stackTrace)

Unsupported, ForeignException instances are by definition foreign and thus stacktraces should not be controllable by the guest.

Overrides:

setStackTrace in class Throwable

fillInStackTrace

public Throwable fillInStackTrace()

Overrides:

fillInStackTrace in class Throwable

initCause

public Throwable initCause(Throwable cause)

Overrides:

initCause in class Throwable