org.grouplens.grapht

Class InjectionContainer

java.lang.Object

org.grouplens.grapht.InjectionContainer

public class InjectionContainer
extends Object

Container for dependency-injected components. A container is the scope of memoization, so components with a cache policy of CachePolicy.MEMOIZE will share an instance so long as they are instantiated by the same instantiator.

Since:

0.9

Author:

GroupLens Research

Method Summary

Modifier and Type	Method and Description
static InjectionContainer	create() Create a new instantiator with a default policy of MEMOIZE.
static InjectionContainer	create(CachePolicy dft) Create a new instantiator without a lifecycle manager.
static InjectionContainer	create(CachePolicy dft, LifecycleManager mgr) Create a new instantiator.
LifecycleManager	getLifecycleManager() Get the lifecycle manager for this container.
Instantiator	makeInstantiator(DAGNode<Component,Dependency> node) Get a provider that, when invoked, will return an instance of the component represented by a graph.
Instantiator	makeInstantiator(DAGNode<Component,Dependency> node, com.google.common.collect.SetMultimap<DAGNode<Component,Dependency>,DAGEdge<Component,Dependency>> backEdges) Get a provider that, when invoked, will return an instance of the component represented by a graph with back edges.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static InjectionContainer create()

Create a new instantiator with a default policy of MEMOIZE.

Returns:

The instantiator.

create

public static InjectionContainer create(CachePolicy dft)

Create a new instantiator without a lifecycle manager.

Parameters:

dft - The default cache policy.

Returns:

The instantiator.

create

public static InjectionContainer create(CachePolicy dft,
                                        LifecycleManager mgr)

Create a new instantiator.

Parameters:

dft - The default cache policy.

mgr - The lifecycle manager.

Returns:

The instantiator.

makeInstantiator

public Instantiator makeInstantiator(DAGNode<Component,Dependency> node)

Get a provider that, when invoked, will return an instance of the component represented by a graph.

Parameters:

node - The graph.

Returns:

A provider to instantiate graph.

See Also:

makeInstantiator(DAGNode, SetMultimap)

makeInstantiator

public Instantiator makeInstantiator(DAGNode<Component,Dependency> node,
                                     com.google.common.collect.SetMultimap<DAGNode<Component,Dependency>,DAGEdge<Component,Dependency>> backEdges)

Get a provider that, when invoked, will return an instance of the component represented by a graph with back edges. The provider will implement the cache policy, so cached nodes will return a memoized provider.

Parameters:

node - The graph.

backEdges - A multimap of back edges for cyclic dependencies.

Returns:

A provider to instantiate graph.

getLifecycleManager

@Nullable
public LifecycleManager getLifecycleManager()

Get the lifecycle manager for this container.

Returns:

The lifecycle manager for the container.