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 and cause. 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;
 }
 

Since:

21.0

See Also:

Interop.throwException(Object), Serialized Form

Method Summary

Modifier and Type	Method and Description
Throwable	fillInStackTrace()
Throwable	getCause()
String	getMessage()
StackTraceElement[]	getStackTrace()
Throwable	initCause(Throwable cause)
void	setStackTrace(StackTraceElement[] stackTrace) Unsupported, ForeignException instances are not writable therefore setting the stack trace has no effect for them.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Method Detail

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getCause

public Throwable getCause()

Overrides:

getCause in class Throwable

getStackTrace

public StackTraceElement[] getStackTrace()

Overrides:

getStackTrace in class Throwable

setStackTrace

public void setStackTrace(StackTraceElement[] stackTrace)

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

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