edu.rice.hj.api

Class SuspendableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

edu.rice.hj.api.SuspendableException

All Implemented Interfaces:

Serializable

public final class SuspendableException
extends Exception

SuspendableException is an exception used to mark tasks that can possibly suspend. The constructor is private to disallow instance creation, it is a \emph{marker} exception.

Runtime implementations can choose to implement such tasks via blocking of worker threads or or via non-blocking using continuations.

An exception used to initiate the control transfer.

It does not support stack traces.

Methods which are declared to throw this exception are "suspendable". This exception must always be propagated and never be caught.

Generic try/catch handlers are allowed:
try{ doSomething(); } catch(Throwable ex) { handleException(ex); }

The instrumentation ANT task will enhance the bytecode of these methods to support suspension and continuation of their execution.

Author:

Matthias Mann, Shams Imam (shams@rice.edu)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static SuspendableException	instance

Method Summary

Modifier and Type	Method and Description
Throwable	fillInStackTrace()

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

instance

public static final SuspendableException instance

Method Detail

fillInStackTrace

public Throwable fillInStackTrace()

Overrides:

fillInStackTrace in class Throwable