Package org.refcodes.component

Class CompositeComponentImpl<C extends Component>

java.lang.Object

org.refcodes.component.CompositeComponentImpl<C>

Type Parameters:

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

All Implemented Interfaces:

java.io.Flushable, Closable, CompositeComponent, Decomposeable, Destroyable, Flushable, Initializable, LifeCycleComponent, LinkComponent, Openable, Pausable, Resetable, Resumable, Startable, Stoppable, org.refcodes.mixin.Disposable

Direct Known Subclasses:

CompositeComponentImpl.ExtendedCompositeComponentImpl

public class CompositeComponentImpl<C extends Component>
extends java.lang.Object
implements CompositeComponent

The CompositeComponentImpl is an implementation of the CompositeComponent. 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	CompositeComponentImpl.ExtendedCompositeComponentImpl<C extends Component,CTX,CON>	The CompositeComponentImpl.ExtendedCompositeComponentImpl is an implementation of the CompositeComponent.ExtendedCompositeComponent.

Nested classes/interfaces inherited from interface org.refcodes.component.Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B extends Closable.CloseBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.CompositeComponent

CompositeComponent.ExtendedCompositeComponent<CTX,CON>

Nested classes/interfaces inherited from interface org.refcodes.component.Decomposeable

Decomposeable.DecomposeAutomaton

Nested classes/interfaces inherited from interface org.refcodes.component.Destroyable

Destroyable.DestroyAutomaton

Nested classes/interfaces inherited from interface org.refcodes.mixin.Disposable

org.refcodes.mixin.Disposable.Disposedable

Nested classes/interfaces inherited from interface org.refcodes.component.Flushable

Flushable.FlushBuilder<B extends Flushable.FlushBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Initializable

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

Nested classes/interfaces inherited from interface org.refcodes.component.LifeCycleComponent

LifeCycleComponent.LifeCycleAutomaton, LifeCycleComponent.UncheckedLifeCycleComponent

Nested classes/interfaces inherited from interface org.refcodes.component.LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B extends LinkComponent.LinkComponentBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B extends Openable.OpenBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Pausable

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

Nested classes/interfaces inherited from interface org.refcodes.component.Resumable

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

Nested classes/interfaces inherited from interface org.refcodes.component.Startable

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

Nested classes/interfaces inherited from interface org.refcodes.component.Stoppable

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

Constructor Summary

Constructors

Constructor	Description
CompositeComponentImpl(C... aComponents)	Creates a CompositeComponentImpl containing the provided components.
CompositeComponentImpl(java.util.Collection<C> aComponents)	Creates a CompositeComponentImpl containing the provided components.
CompositeComponentImpl(org.refcodes.controlflow.ExecutionStrategy aStrategy, C... aComponents)	Creates a CompositeComponentImpl containing the provided components.
CompositeComponentImpl(org.refcodes.controlflow.ExecutionStrategy aStrategy, java.util.Collection<C> aComponents)	Creates a CompositeComponentImpl 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 java.util.Set<C>	getComponents()	Provides access to the Component instances.
protected org.refcodes.controlflow.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()	Resets the component.
void	resume()	Resumes the component.
void	start()	Starts the component.
void	stop()	Stops the component.

Methods inherited from interface org.refcodes.component.Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface org.refcodes.component.Flushable

flushUnchecked, isFlushable

Methods inherited from interface org.refcodes.component.Initializable

initializeUnchecked

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.component.Openable

openUnchecked

Methods inherited from interface org.refcodes.component.Pausable

pauseUnchecked

Methods inherited from interface org.refcodes.component.Resumable

resumeUnchecked

Methods inherited from interface org.refcodes.component.Startable

startUnchecked

Methods inherited from interface org.refcodes.component.Stoppable

stopUnchecked

Constructor Detail

CompositeComponentImpl

public CompositeComponentImpl(java.util.Collection<C> aComponents)

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

Parameters:

aComponents - The components to be managed by the CompositeComponentImpl.

CompositeComponentImpl

public CompositeComponentImpl(org.refcodes.controlflow.ExecutionStrategy aStrategy,
                              java.util.Collection<C> aComponents)

Creates a CompositeComponentImpl containing the provided components.

Parameters:

aStrategy - The ExecutionStrategy for executing the state change requests.

aComponents - The components to be managed by the CompositeComponentImpl.

CompositeComponentImpl

@SafeVarargs
public CompositeComponentImpl(C... aComponents)

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

Parameters:

aComponents - The components to be managed by the CompositeComponentImpl.

CompositeComponentImpl

@SafeVarargs
public CompositeComponentImpl(org.refcodes.controlflow.ExecutionStrategy aStrategy,
                              C... aComponents)

Creates a CompositeComponentImpl containing the provided components.

Parameters:

aStrategy - The ExecutionStrategy for executing the state change requests.

aComponents - The components to be managed by the CompositeComponentImpl.

Method Detail

flush

public void flush()
           throws OpenException

Specified by:

flush in interface java.io.Flushable

Specified by:

flush in interface Flushable

Throws:

OpenException

decompose

public void decompose()

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

Specified by:

decompose in interface Decomposeable

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()

Resets the component. No exception is thrown as decomposition must work always!

Specified by:

reset in interface Resetable

open

public void open()
          throws OpenException

Open the component's connection(s).

Specified by:

open in interface Openable

Throws:

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

close

public void close()

Closes the component's connection(s). Throws a CloseException 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

dispose

public void dispose()

Specified by:

dispose in interface org.refcodes.mixin.Disposable

getExecutionStrategy

protected org.refcodes.controlflow.ExecutionStrategy getExecutionStrategy()

Provides access to the ExecutionStrategy.

Returns:

The ExecutionStrategy being set.

getComponents

protected java.util.Set<C> getComponents()

Provides access to the Component instances.

Returns:

The Component instances being set.