Module org.refcodes.component

Package org.refcodes.component

Interface ResumableHandle<H>

Type Parameters:

H - The type of the handle.

All Known Subinterfaces:

CompositeComponentHandle<H,REF>, ConfigurableLifecycleComponentHandle<H,CTX>, ConfigurableLifecycleComponentHandle.ConfigurableLifecycleAutomatonHandle<H,CTX>, LifecycleComponentHandle<H>, LifecycleComponentHandle.LifecycleAutomatonHandle<H>, ResumableHandle.ResumeAutomatonHandle<H>

public interface ResumableHandle<H>

The ResumableHandle interface defines those methods related to the handle based resume life-cycle.

The handle reference requires the Resumable interface to be implemented.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ResumableHandle.ResumeAutomatonHandle<H>	The ResumableHandle.ResumeAutomatonHandle interface defines those methods related to the handle based resume life-cycle.

Method Summary

Modifier and Type	Method	Description
boolean	hasResumable(H aHandle)	Determines whether the handle reference is resumable by implementing the Resumable interface.
void	resume(H aHandle)	Resumes the component identified by the given handle.
default void	resumeUnchecked(H aHandle)	Resumes the component by calling resume(Object) without you to require catching an ResumeException.

Method Details

hasResumable

boolean hasResumable(H aHandle)
              throws UnknownHandleRuntimeException

Determines whether the handle reference is resumable by implementing the Resumable interface.

Parameters:

aHandle - The handle to test whether the reference provides the according functionality.

Returns:

True in case the reference provides the according functionality.

Throws:

UnknownHandleRuntimeException - in case the handle is unknown.

resume

void resume(H aHandle)
     throws ResumeException,
UnknownHandleRuntimeException,
UnsupportedHandleOperationRuntimeException,
IllegalHandleStateChangeRuntimeException

Resumes the component identified by the given handle.

Parameters:

aHandle - The handle identifying the component.

Throws:

ResumeException - in case resuming fails.

UnknownHandleRuntimeException - in case the given handle is unknown.

UnsupportedHandleOperationRuntimeException - in case the reference of the handle does not support the requested operation.

IllegalHandleStateChangeRuntimeException - Thrown in case a state change is not possible due to the current state the referenced component is in.

resumeUnchecked

default void resumeUnchecked(H aHandle)

Resumes the component by calling resume(Object) without you to require catching an ResumeException.

Parameters:

aHandle - The handle identifying the component.

Throws:

ResumeException.ResumeRuntimeException - encapsulates the cause and is thrown upon encountering a ResumeException exception