Module org.refcodes.component

Package org.refcodes.component

Interface ConfigurableHandle<H,CTX>

Type Parameters:

H - The type of the handle.

CTX - The context used to initialize the referenced instance.

All Known Subinterfaces:

ConfigurableHandle.ConfigureAutomatonHandle<H,CTX>, ConfigurableLifecycleComponentHandle<H,CTX>, ConfigurableLifecycleComponentHandle.ConfigurableLifecycleAutomatonHandle<H,CTX>

public interface ConfigurableHandle<H,CTX>

The ConfigurableHandle interface defines those methods related to the handle based initialize/configure life-cycle.

The handle reference requires the Configurable interface to be implemented.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ConfigurableHandle.ConfigureAutomatonHandle<H,CTX>	The ConfigurableHandle.ConfigureAutomatonHandle interface defines those methods related to the handle based initialize/configure life-cycle.

Method Summary

Modifier and Type	Method	Description
boolean	hasConfigurable(H aHandle)	Determines whether the handle reference is configurable by implementing the Configurable interface.
void	initialize(H aHandle, CTX aContext)	Initialize/configure the component identified by the given handle.
default void	initializeUnchecked(H aHandle, CTX aContext)	Initializes the component by calling initialize(Object, Object) without you to require catching an ConfigureException.

Method Detail

hasConfigurable

boolean hasConfigurable(H aHandle)
                 throws UnknownHandleRuntimeException

Determines whether the handle reference is configurable by implementing the Configurable 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,
                CTX aContext)
         throws ConfigureException,
                UnknownHandleRuntimeException,
                UnsupportedHandleOperationRuntimeException,
                IllegalHandleStateChangeRuntimeException

Initialize/configure the component identified by the given handle.

Parameters:

aHandle - The handle identifying the component.

aContext - The context to be passed to the implementing instance.

Throws:

ConfigureException - in case initializing 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.

initializeUnchecked

default void initializeUnchecked(H aHandle,
                                 CTX aContext)

Initializes the component by calling initialize(Object, Object) without you to require catching an ConfigureException.

Parameters:

aHandle - The handle identifying the component.

aContext - The context to be passed to the implementing instance.

Throws:

ConfigureException.ConfigureRuntimeException - encapsulates the cause and is thrown upon encountering a ConfigureException exception