org.refcodes.component

Interface InitializableHandle<H>

Type Parameters:

H - The type of the handle.

All Known Subinterfaces:

CompositeComponentHandle<H,REF>, ConfigurableLifeCycleComponentHandle.ConfigurableLifeCycleAutomatonHandle<H,CTX>, InitializableHandle.InitializeAutomatonHandle<H>, LifeCycleComponentHandle<H>, LifeCycleComponentHandle.LifeCycleAutomatonHandle<H>

public interface InitializableHandle<H>

The InitializableHandle interface defines those methods related to the handle based initialize life-cycle.

The handle reference requires the Initializable interface to be implemented.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	InitializableHandle.InitializeAutomatonHandle<H> The InitializableHandle.InitializeAutomatonHandle interface defines those methods related to the handle based initialize life-cycle.

Method Summary

Modifier and Type	Method and Description
boolean	hasInitalizable(H aHandle) Determines whether the handle reference is initializeable by implementing the Initializable interface.
void	initialize(H aHandle) Initialize the component identified by the given handle.

Method Detail

hasInitalizable

boolean hasInitalizable(H aHandle)
                 throws UnknownHandleRuntimeException

Determines whether the handle reference is initializeable by implementing the Initializable 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.

initialize

void initialize(H aHandle)
         throws InitializeException,
                UnknownHandleRuntimeException,
                UnsupportedHandleOperationRuntimeException,
                IllegaleHandleStateChangeRuntimeException

Initialize the component identified by the given handle.

Parameters:

aHandle - The handle identifying the component.

Throws:

InitializeException - in case initializing fails.

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

UnknownHandleRuntimeException - in case the given handle is unknown.

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