com.google.inject.internal

Class ProviderMethod<T>

java.lang.Object

com.google.inject.internal.ProviderMethod<T>

All Implemented Interfaces:

HasDependencies, ProviderWithExtensionVisitor<T>, ProvidesMethodBinding<T>, javax.inject.Provider<T>

Direct Known Subclasses:

ProviderMethod.FastClassProviderMethod, ProviderMethod.ReflectionProviderMethod

public abstract class ProviderMethod<T>
extends java.lang.Object
implements ProviderWithExtensionVisitor<T>, HasDependencies, ProvidesMethodBinding<T>

A provider that invokes a method and returns its result.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ProviderMethod.Factory<T>
private static class	ProviderMethod.FastClassProviderMethod<T> A ProviderMethod implementation that uses FastClass.invoke(java.lang.String, java.lang.Class[], java.lang.Object, java.lang.Object[]) to invoke the provider method.
private static class	ProviderMethod.ProviderMethodProviderInstanceBindingImpl<T>
private static class	ProviderMethod.ReflectionProviderMethod<T> A ProviderMethod implementation that invokes the method using normal java reflection.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.annotation.Annotation	annotation
private com.google.common.collect.ImmutableSet<Dependency<?>>	dependencies
private boolean	exposed
protected java.lang.Object	instance
private Key<T>	key
protected java.lang.reflect.Method	method
private java.util.List<Provider<?>>	parameterProviders
private java.lang.Class<? extends java.lang.annotation.Annotation>	scopeAnnotation

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ProviderMethod(Key<T> key, java.lang.reflect.Method method, java.lang.Object instance, com.google.common.collect.ImmutableSet<Dependency<?>> dependencies, java.util.List<Provider<?>> parameterProviders, java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation, java.lang.annotation.Annotation annotation)

Method Summary

Modifier and Type	Method and Description
<B,V> V	acceptExtensionVisitor(BindingTargetVisitor<B,V> visitor, ProviderInstanceBinding<? extends B> binding) Instructs the extension determine if the visitor is an instance of a custom extension visitor, and if so, visit it using that method.
void	configure(Binder binder)
(package private) static <T> ProviderMethod<T>	create(Key<T> key, java.lang.reflect.Method method, java.lang.Object instance, com.google.common.collect.ImmutableSet<Dependency<?>> dependencies, java.util.List<Provider<?>> parameterProviders, java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation, boolean skipFastClassGeneration, java.lang.annotation.Annotation annotation) Creates a ProviderMethod.
(package private) static <T> BindingImpl<T>	createBinding(InjectorImpl injector, Key<T> key, ProviderMethod<T> providerMethod, java.lang.Object source, Scoping scoping)
(package private) abstract T	doProvision(java.lang.Object[] parameters) Extension point for our subclasses to implement the provisioning strategy.
boolean	equals(java.lang.Object obj)
T	get() Provides an instance of T.
java.lang.annotation.Annotation	getAnnotation() Returns the annotation that caused this binding to be created.
java.util.Set<Dependency<?>>	getDependencies() Returns the known dependencies for this type.
java.lang.Object	getEnclosingInstance() Returns the instance of the object the method is defined in.
java.lang.Object	getInstance()
Key<T>	getKey() Returns the key of the binding.
java.lang.reflect.Method	getMethod() Returns the method this binding uses.
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

instance

protected final java.lang.Object instance

method

protected final java.lang.reflect.Method method

key

private final Key<T> key

scopeAnnotation

private final java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation

dependencies

private final com.google.common.collect.ImmutableSet<Dependency<?>> dependencies

parameterProviders

private final java.util.List<Provider<?>> parameterProviders

exposed

private final boolean exposed

annotation

private final java.lang.annotation.Annotation annotation

Constructor Detail

ProviderMethod

private ProviderMethod(Key<T> key,
                       java.lang.reflect.Method method,
                       java.lang.Object instance,
                       com.google.common.collect.ImmutableSet<Dependency<?>> dependencies,
                       java.util.List<Provider<?>> parameterProviders,
                       java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation,
                       java.lang.annotation.Annotation annotation)

Parameters:

method - the method to invoke. It's return type must be the same type as key.

Method Detail

create

static <T> ProviderMethod<T> create(Key<T> key,
                                    java.lang.reflect.Method method,
                                    java.lang.Object instance,
                                    com.google.common.collect.ImmutableSet<Dependency<?>> dependencies,
                                    java.util.List<Provider<?>> parameterProviders,
                                    java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation,
                                    boolean skipFastClassGeneration,
                                    java.lang.annotation.Annotation annotation)

Creates a ProviderMethod.

Unless skipFastClassGeneration is set, this will use FastClass to invoke the actual method, since it is significantly faster. However, this will fail if the method is private or protected, since fastclass is subject to java access policies.

getKey

public Key<T> getKey()

Description copied from interface: ProvidesMethodBinding

Returns the key of the binding.

Specified by:

getKey in interface ProvidesMethodBinding<T>

getMethod

public java.lang.reflect.Method getMethod()

Description copied from interface: ProvidesMethodBinding

Returns the method this binding uses.

Specified by:

getMethod in interface ProvidesMethodBinding<T>

getInstance

public java.lang.Object getInstance()

getEnclosingInstance

public java.lang.Object getEnclosingInstance()

Description copied from interface: ProvidesMethodBinding

Returns the instance of the object the method is defined in.

Specified by:

getEnclosingInstance in interface ProvidesMethodBinding<T>

getAnnotation

public java.lang.annotation.Annotation getAnnotation()

Description copied from interface: ProvidesMethodBinding

Returns the annotation that caused this binding to be created. For @Provides methods, this is an instance of the @Provides annotation. For bindings from ModuleAnnotatedMethodScanner, this is the annotation that caused the scanner to produce the binding.

Specified by:

getAnnotation in interface ProvidesMethodBinding<T>

configure

public void configure(Binder binder)

get

public T get()

Description copied from interface: Provider

Provides an instance of T. Must never return null.

Specified by:

get in interface javax.inject.Provider<T>

doProvision

abstract T doProvision(java.lang.Object[] parameters)
                throws java.lang.IllegalAccessException,
                       java.lang.reflect.InvocationTargetException

Extension point for our subclasses to implement the provisioning strategy.

Throws:

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

getDependencies

public java.util.Set<Dependency<?>> getDependencies()

Description copied from interface: HasDependencies

Returns the known dependencies for this type. If this has dependencies whose values are not known statically, a dependency for the Injector will be included in the returned set.

Specified by:

getDependencies in interface HasDependencies

Returns:

a possibly empty set

acceptExtensionVisitor

public <B,V> V acceptExtensionVisitor(BindingTargetVisitor<B,V> visitor,
                                      ProviderInstanceBinding<? extends B> binding)

Description copied from interface: ProviderWithExtensionVisitor

Instructs the extension determine if the visitor is an instance of a custom extension visitor, and if so, visit it using that method. If the visitor is not an instance of the custom extension visitor, this method MUST call visitor.visit(binding).

Due to issues with generics, the type parameters of this method do not relate to the type of the provider. In practice, the 'B' type will always be a supertype of 'T'.

Specified by:

acceptExtensionVisitor in interface ProviderWithExtensionVisitor<T>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

createBinding

static <T> BindingImpl<T> createBinding(InjectorImpl injector,
                                        Key<T> key,
                                        ProviderMethod<T> providerMethod,
                                        java.lang.Object source,
                                        Scoping scoping)