org.symphonyoss.s2.fugue.di

Interface IDIContext

All Known Implementing Classes:

DIContext

public interface IDIContext

A Dependency Injection Context.

Author:

Bruce Skingle

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.
IDIContext	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.

Method Detail

stop

void stop()

Stop the context.

register

IDIContext register(IComponent component)

Register the given component in the context.

Parameters:

component - A component.

Returns:

The context (fluent interface).

resolveAndStart

void resolveAndStart()

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

resolve

void resolve()

Resolve all components. May only be called once.

start

void start()

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

getLifeCycle

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

Get the current lifeCycle state.

Returns:

the current lifeCycle state.

waitForLifeCycle

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

Wait for the specified lifeCycle state to be reached.

Parameters:

lifeCycle - The state to wait for.

Throws:

InterruptedException - If the call is interrupted.

join

void join()
   throws InterruptedException

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.

Throws:

InterruptedException - If the call is interrupted.

resolveAdditionalComponent

boolean resolveAdditionalComponent(IComponent component)

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.

Parameters:

component - A component to be resolved.

Returns:

True if all dependencies of the new component were resolved.