Class AbstractComponentComposite<C extends Component>

java.lang.Object

org.refcodes.component.AbstractComponentComposite<C>

Type Parameters:

C - The type of the Component supported by the AbstractComponentComposite.

All Implemented Interfaces:

Flushable, Closable, ComponentComposite, Decomposable, Destroyable, Flushable, Initializable, LifecycleComponent, LinkComponent, Openable, Pausable, Resumable, Startable, Stoppable, Disposable, Resetable

Direct Known Subclasses:

AbstractComponentComposite.ExtendedCompositeComponentImpl

public abstract class AbstractComponentComposite<C extends Component>
extends Object
implements ComponentComposite

The AbstractComponentComposite is an implementation of the ComponentComposite. To make sure that the state change requests you require are supported by the managed Component instances, specify the according type C as generic type argument.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractComponentComposite.ExtendedCompositeComponentImpl<C extends Component, CTX, CON>	The AbstractComponentComposite.ExtendedCompositeComponentImpl is an implementation of the ComponentComposite.ExtendedComponentComposite.

Nested classes/interfaces inherited from interface Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B>

Nested classes/interfaces inherited from interface ComponentComposite

ComponentComposite.ExtendedComponentComposite<CTX,CON>

Nested classes/interfaces inherited from interface Decomposable

Decomposable.DecomposeAutomaton

Nested classes/interfaces inherited from interface Destroyable

Destroyable.DestroyAutomaton

Nested classes/interfaces inherited from interface Flushable

Flushable.FlushBuilder<B>

Nested classes/interfaces inherited from interface Initializable

Initializable.InitializeAutomaton, Initializable.InitializeBuilder<B>, Initializable.UncheckedInitializable

Nested classes/interfaces inherited from interface LifecycleComponent

LifecycleComponent.LifecycleAutomaton, LifecycleComponent.UncheckedLifecycleComponent

Nested classes/interfaces inherited from interface LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B>

Nested classes/interfaces inherited from interface Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B>

Nested classes/interfaces inherited from interface Pausable

Pausable.PauseAutomaton, Pausable.PauseBuilder<B>, Pausable.UncheckedPausable

Nested classes/interfaces inherited from interface Resumable

Resumable.ResumeAutomaton, Resumable.ResumeBuilder<B>, Resumable.UncheckedResumable

Nested classes/interfaces inherited from interface Startable

Startable.StartAutomaton, Startable.StartBuilder<B>, Startable.UncheckedStartable

Nested classes/interfaces inherited from interface Stoppable

Stoppable.StopAutomaton, Stoppable.StopBuilder<B>, Stoppable.UncheckedStoppable

Constructor Summary

Constructors

Constructor	Description
AbstractComponentComposite(C... aComponents)	Creates a AbstractComponentComposite containing the provided components.
AbstractComponentComposite(Collection<C> aComponents)	Creates a AbstractComponentComposite containing the provided components.
AbstractComponentComposite(ExecutionStrategy aStrategy, C... aComponents)	Creates a AbstractComponentComposite containing the provided components.
AbstractComponentComposite(ExecutionStrategy aStrategy, Collection<C> aComponents)	Creates a AbstractComponentComposite containing the provided components.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the component's connection(s).
void	decompose()	Decomposes the component.
void	destroy()	Destroys the component.
void	dispose()
void	flush()
protected Set<C>	getComponents()	Provides access to the Component instances.
protected ExecutionStrategy	getExecutionStrategy()	Provides access to the ExecutionStrategy.
void	initialize()	Initialize the component.
void	open()	Open the component's connection(s).
void	pause()	Pauses the component.
void	reset()
void	resume()	Resumes the component.
void	start()	Starts the component.
void	stop()	Stops the component.

Methods inherited from class Object

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

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface Flushable

flushUnchecked, isFlushable

Methods inherited from interface Initializable

initializeUnchecked

Methods inherited from interface Openable

openUnchecked

Methods inherited from interface Pausable

pauseUnchecked

Methods inherited from interface Resumable

resumeUnchecked

Methods inherited from interface Startable

startUnchecked

Methods inherited from interface Stoppable

stopUnchecked

Constructor Details

AbstractComponentComposite

public AbstractComponentComposite(Collection<C> aComponents)

Creates a AbstractComponentComposite containing the provided components. The ExecutionStrategy.JOIN ExecutionStrategy is used by default.

Parameters:

aComponents - The components to be managed by the AbstractComponentComposite.

AbstractComponentComposite

public AbstractComponentComposite(ExecutionStrategy aStrategy,
 Collection<C> aComponents)

Creates a AbstractComponentComposite containing the provided components.

Parameters:

aStrategy - The ExecutionStrategy for executing the state change requests.

aComponents - The components to be managed by the AbstractComponentComposite.

AbstractComponentComposite

@SafeVarargs
public AbstractComponentComposite(C... aComponents)

Creates a AbstractComponentComposite containing the provided components. The ExecutionStrategy.JOIN ExecutionStrategy is used by default.

Parameters:

aComponents - The components to be managed by the AbstractComponentComposite.

AbstractComponentComposite

@SafeVarargs
public AbstractComponentComposite(ExecutionStrategy aStrategy,
 C... aComponents)

Creates a AbstractComponentComposite containing the provided components.

Parameters:

aStrategy - The ExecutionStrategy for executing the state change requests.

aComponents - The components to be managed by the AbstractComponentComposite.

Method Details

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Specified by:

flush in interface Flushable

Throws:

IOException

decompose

public void decompose()

Decomposes the component. External resources might get deleted (such as files or DB schemas)!

Specified by:

decompose in interface Decomposable

destroy

public void destroy()

Destroys the component. External resources might stay untouched! This should always be possible and must not throw any exception. In case a Component has been destroyed, then invoking any of that Component instance's methods (except the Destroyable.destroy() method) must throw an IllegalStateException as by definition a once destroyed Component is in the state of being destroyed which is irreversible.

Specified by:

destroy in interface Destroyable

stop

public void stop()
          throws StopException

Stops the component.

Specified by:

stop in interface Stoppable

Throws:

StopException - Thrown in case stopping fails.

resume

public void resume()
            throws ResumeException

Resumes the component.

Specified by:

resume in interface Resumable

Throws:

ResumeException - Thrown in case resuming fails.

pause

public void pause()
           throws PauseException

Pauses the component.

Specified by:

pause in interface Pausable

Throws:

PauseException - in case pausing fails.

start

public void start()
           throws StartException

Starts the component.

Specified by:

start in interface Startable

Throws:

StartException - Thrown in case starting fails.

initialize

public void initialize()
                throws InitializeException

Initialize the component.

Specified by:

initialize in interface Initializable

Throws:

InitializeException - Thrown in case initializing fails.

reset

public void reset()

Specified by:

reset in interface Resetable

open

public void open()
          throws IOException

Open the component's connection(s).

Specified by:

open in interface Openable

Throws:

IOException - Thrown in case opening or accessing an open line (connection, junction, link) caused problems.

close

public void close()
           throws IOException

Closes the component's connection(s). Throws a IOException as upon close we may have to do things like flushing buffers which can fail (and would otherwise fail unhandled or even worse unnoticed).

Specified by:

close in interface Closable

Throws:

IOException - thrown in case closing failed.

dispose

public void dispose()

Specified by:

dispose in interface Disposable

getExecutionStrategy

protected ExecutionStrategy getExecutionStrategy()

Provides access to the ExecutionStrategy.

Returns:

The ExecutionStrategy being set.

getComponents

protected Set<C> getComponents()

Provides access to the Component instances.

Returns:

The Component instances being set.