net.sandius.rembulan.runtime

Interface Resumable

All Known Subinterfaces:

ProtectedResumable

All Known Implementing Classes:

AbstractFunction0, AbstractFunction1, AbstractFunction2, AbstractFunction3, AbstractFunction4, AbstractFunction5, AbstractFunctionAnyArg, LuaFunction, UnimplementedFunction

public interface Resumable

An interface for resuming suspended Lua function calls.

Method Summary

Modifier and Type	Method and Description
void	resume(ExecutionContext context, Object suspendedState) Resumes this resumable in the given execution context context, passing the suspended state suspendedState to it.

Method Detail

resume

void resume(ExecutionContext context,
            Object suspendedState)
     throws ResolvedControlThrowable

Resumes this resumable in the given execution context context, passing the suspended state suspendedState to it. This method throws a ResolvedControlThrowable: this method is expected to have resolved non-local control changes up to the point of its invocation.

This method is called by the call executor when resuming a previously suspended function call, possibly with a different execution context. suspendedState is guaranteed by the executor to be equivalent to the suspended state registered by the call to UnresolvedControlThrowable.resolve(Resumable, Object). Equivalence here means that the class will be equal to that of the state object previously registered; however, the actual instance passed to this method may be a clone or a (serialised and) de-serialised version of the original object.

Implementations of this method may safely assume that context is not null.

Parameters:

context - execution context, non-null when called by a call executor

suspendedState - suspended state, equivalent to the suspended state registered with the call executor

Throws:

ResolvedControlThrowable - if the resumed call initiates a non-local control change