org.symphonyoss.s2.fugue.di

Class DIContext

java.lang.Object

org.symphonyoss.s2.fugue.di.DIContext

All Implemented Interfaces:

IDIContext

public class DIContext
extends Object
implements IDIContext

A dependency injection context.

Author:

Bruce Skingle

Constructor Summary

Constructors

Constructor and Description
DIContext()

Method Summary

Modifier and Type	Method and Description
org.symphonyoss.s2.fugue.di.DIContextState	getLifeCycle() Get the current lifeCycle state.
void	join() Wait for the context to become stopped.
DIContext	register(IComponent component) Register the given component in the context.
void	resolve() Resolve all components.
boolean	resolveAdditionalComponent(IComponent component) Resolve an additional component.
void	resolveAndStart() Resolve all components and start.
void	start() Start all components.
void	stop() Stop the context.
void	waitForLifeCycle(org.symphonyoss.s2.fugue.di.DIContextState lifeCycle) Wait for the specified lifeCycle state to be reached.

Methods inherited from class java.lang.Object

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

Constructor Detail

DIContext

public DIContext()

Method Detail

register

public DIContext register(IComponent component)

Description copied from interface: IDIContext

Register the given component in the context.

Specified by:

register in interface IDIContext

Parameters:

component - A component.

Returns:

The context (fluent interface).

resolveAndStart

public void resolveAndStart()

Description copied from interface: IDIContext

Resolve all components and start. May only be called once.

Specified by:

resolveAndStart in interface IDIContext

resolve

public void resolve()

Description copied from interface: IDIContext

Resolve all components. May only be called once.

Specified by:

resolve in interface IDIContext

resolveAdditionalComponent

public boolean resolveAdditionalComponent(IComponent component)

Description copied from interface: IDIContext

Resolve an additional component. This method allows a new component to be resolved after the context has been resolved and started. The new component cannot provide any interfaces to other components and will not be visible to running components, or components subsequently added by a further call to this method. Dependencies of the given component will be resolved and injected if possible.

Specified by:

resolveAdditionalComponent in interface IDIContext

Parameters:

component - A component to be resolved.

Returns:

True if all dependencies of the new component were resolved.

start

public void start()

Description copied from interface: IDIContext

Start all components. May only be called once, after the context is resolved.

Specified by:

start in interface IDIContext

stop

public void stop()

Description copied from interface: IDIContext

Stop the context.

Specified by:

stop in interface IDIContext

getLifeCycle

public org.symphonyoss.s2.fugue.di.DIContextState getLifeCycle()

Description copied from interface: IDIContext

Get the current lifeCycle state.

Specified by:

getLifeCycle in interface IDIContext

Returns:

the current lifeCycle state.

waitForLifeCycle

public void waitForLifeCycle(org.symphonyoss.s2.fugue.di.DIContextState lifeCycle)
                      throws InterruptedException

Description copied from interface: IDIContext

Wait for the specified lifeCycle state to be reached.

Specified by:

waitForLifeCycle in interface IDIContext

Parameters:

lifeCycle - The state to wait for.

Throws:

InterruptedException - If the call is interrupted.

join

public void join()
          throws InterruptedException

Description copied from interface: IDIContext

Wait for the context to become stopped. In a simple app where the main thread wants to block until the app is complete, this is the method to call.

Specified by:

join in interface IDIContext

Throws:

InterruptedException - If the call is interrupted.