org.grouplens.grapht.reflect.internal

Class ProviderInstanceSatisfaction

java.lang.Object

org.grouplens.grapht.reflect.internal.ProviderInstanceSatisfaction

All Implemented Interfaces:

Serializable, Satisfaction

public class ProviderInstanceSatisfaction
extends Object
implements Satisfaction, Serializable

Satisfaction implementation wrapping an existing Provider instance. It has no dependencies and it always returns the same Provider when Satisfaction.makeInstantiator(Map, LifecycleManager) is invoked.

Author:

GroupLens Research

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ProviderInstanceSatisfaction(javax.inject.Provider<?> provider) Create a new satisfaction that wraps the given Provider instance.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
CachePolicy	getDefaultCachePolicy() Get the default cache policy for instances created by this satisfaction.
List<Desire>	getDependencies() Get this satisfaction's dependencies.
Class<?>	getErasedType() Get the type-erased class of this satisfaction's type.
javax.inject.Provider<?>	getProvider()
Type	getType() Get the type of this satisfaction.
int	hashCode()
boolean	hasInstance() Query whether this satisfaction already has an instance to return.
Instantiator	makeInstantiator(Map<Desire,Instantiator> dependencies, LifecycleManager lm) Create an instantiator from this satisfaction.
String	toString()
<T> T	visit(SatisfactionVisitor<T> visitor) Visit the satisfaction.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ProviderInstanceSatisfaction

public ProviderInstanceSatisfaction(javax.inject.Provider<?> provider)

Create a new satisfaction that wraps the given Provider instance.

Parameters:

provider - The provider

Throws:

NullPointerException - if provider is null

Method Detail

getDefaultCachePolicy

public CachePolicy getDefaultCachePolicy()

Description copied from interface: Satisfaction

Get the default cache policy for instances created by this satisfaction. In most cases this should be NO_PREFERENCE, but annotations such as Singleton can be used to specify a default. BindingFunctions are allowed to overrule the default cache policy.

Specified by:

getDefaultCachePolicy in interface Satisfaction

Returns:

The default cache policy if no function overrules it

getProvider

public javax.inject.Provider<?> getProvider()

Returns:

The provider instance returned by Satisfaction.makeInstantiator(Map, LifecycleManager)

getDependencies

public List<Desire> getDependencies()

Description copied from interface: Satisfaction

Get this satisfaction's dependencies.

Specified by:

getDependencies in interface Satisfaction

Returns:

A list of dependencies which must be satisfied in order to instantiate this satisfaction.

getType

public Type getType()

Description copied from interface: Satisfaction

Get the type of this satisfaction. If this is a synthetic Satisfaction, then a null type is returned.

Specified by:

getType in interface Satisfaction

Returns:

The type of objects to be instantiated by this satisfaction.

getErasedType

public Class<?> getErasedType()

Description copied from interface: Satisfaction

Get the type-erased class of this satisfaction's type. If this is a synthetic Satisfaction, then null is returned.

Specified by:

getErasedType in interface Satisfaction

Returns:

The class object for this satisfaction's type.

hasInstance

public boolean hasInstance()

Description copied from interface: Satisfaction

Query whether this satisfaction already has an instance to return. If true, then this satisfaction's provider will just return an instance that is already in existence; if false, then its provider may create new instances.

Specified by:

hasInstance in interface Satisfaction

Returns:

whether the satisfaction already has an instance.

visit

public <T> T visit(SatisfactionVisitor<T> visitor)

Description copied from interface: Satisfaction

Visit the satisfaction. This method invokes the appropriate method on the provided visitor to report information on itself.

Specified by:

visit in interface Satisfaction

Type Parameters:

T - The type returned from the visitor.

Parameters:

visitor - The visitor object.

Returns:

The return value from the invoked visitor method.

makeInstantiator

public Instantiator makeInstantiator(Map<Desire,Instantiator> dependencies,
                                     LifecycleManager lm)

Description copied from interface: Satisfaction

Create an instantiator from this satisfaction.

If the details of the Satisfaction require instantiation (e.g. a class or provider class satisfaction), the returned provider should be a new instance, and it should perform no memoization of its own. Caching is the purview of Injector implementations.

If the satisfaction is configured to use specific instances, this rule is obviously void.

Specified by:

makeInstantiator in interface Satisfaction

Parameters:

dependencies - A function mapping desires to providers of their instances.

lm - The lifecycle manager (if one should be used).

Returns:

An instantiator of new instances of the type specified by this satisfaction, instantiated using the specified dependency mapping.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object