Package dagger.android

Class DispatchingAndroidInjector<T>

java.lang.Object

dagger.android.DispatchingAndroidInjector<T>

Type Parameters:

T - the core Android type to be injected

All Implemented Interfaces:

AndroidInjector<T>

@Beta
public final class DispatchingAndroidInjector<T>
extends Object
implements AndroidInjector<T>

Performs members-injection on instances of core Android types (e.g. Activity, Fragment) that are constructed by the Android framework and not by Dagger. This class relies on an injected mapping from each concrete class to an AndroidInjector.Factory for an AndroidInjector of that class. Each concrete class must have its own entry in the map, even if it extends another class which is already present in the map. Calls Object.getClass() on the instance in order to find the appropriate AndroidInjector.Factory.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	DispatchingAndroidInjector.InvalidInjectorBindingException	Exception thrown if an incorrect binding is made for a AndroidInjector.Factory.

Nested classes/interfaces inherited from interface dagger.android.AndroidInjector

AndroidInjector.Builder<T>, AndroidInjector.Factory<T>

Method Summary

Modifier and Type	Method	Description
void	inject(T instance)	Performs members-injection on instance.
boolean	maybeInject(T instance)	Attempts to perform members-injection on instance, returning true if successful, false otherwise.

Methods inherited from class java.lang.Object

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

Method Details

maybeInject

@CanIgnoreReturnValue
public boolean maybeInject(T instance)

Attempts to perform members-injection on instance, returning true if successful, false otherwise.

Throws:

DispatchingAndroidInjector.InvalidInjectorBindingException - if the injector factory bound for a class does not inject instances of that class

inject

public void inject(T instance)

Performs members-injection on instance.

Specified by:

inject in interface AndroidInjector<T>

Throws:

DispatchingAndroidInjector.InvalidInjectorBindingException - if the injector factory bound for a class does not inject instances of that class

IllegalArgumentException - if no AndroidInjector.Factory is bound for instance