InjectorShell is used by InternalInjectorCreator to recursively create a tree of uninitialized Injectors. Each InjectorShell corresponds to either the top-level root injector, or a private child injector.

The root InjectorShell extracts elements from its list of modules and processes these elements to aggregate data that is used to populate its injector's fields. Child injectors are constructed similarly, but using PrivateElements instead of modules.

It is necessary to create the root and child injectors in a single batch because there can be bidirectional parent <-> child injector dependencies that require the entire tree of injectors to be initialized together in the InternalInjectorCreator.

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	InjectorShell.Builder
private static class	InjectorShell.InheritedScannersModule
private static class	InjectorShell.InjectorFactory
private static class	InjectorShell.LoggerFactory
private static class	InjectorShell.RootModule

Modifier and Type	Field and Description
private final List<Element>	elements
private final InjectorImpl	injector

Access	Constructor and Description
private	InjectorShell(List<Element> elements, InjectorImpl injector)

Method Summary

Modifier and Type	Method and Description
private static void	bindInjector(InjectorImpl injector) The Injector is a special case because we allow both parent and child injectors to both have a binding for that key.
private static void	bindLogger(InjectorImpl injector) The Logger is a special case because it knows the injection point of the injected member.
private static void	bindStage(InjectorImpl injector, Stage stage)
pack-priv List<Element>	getElements()
pack-priv InjectorImpl	getInjector()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

elements	back to summary
private final List<Element> elements

injector	back to summary
private final InjectorImpl injector

InjectorShell	back to summary
private InjectorShell(List<Element> elements, InjectorImpl injector)

Method Detail

bindInjector	back to summary
private static void bindInjector(InjectorImpl injector) The Injector is a special case because we allow both parent and child injectors to both have a binding for that key.

bindLogger	back to summary
private static void bindLogger(InjectorImpl injector) The Logger is a special case because it knows the injection point of the injected member. It's the only binding that does this.

bindStage	back to summary
private static void bindStage(InjectorImpl injector, Stage stage)

getElements	back to summary
pack-priv List<Element> getElements()

getInjector	back to summary
pack-priv InjectorImpl getInjector()

com.google.inject.internal back to summary

pack-priv Class InjectorShell.Builder

Class Inheritance

extends Object

java.lang.Object
com.google.inject.internal.InjectorShell.Builder

Field Summary

Modifier and Type	Field and Description
private InjectorBindingData	bindingData
private final List<Element>	elements
private InjectorJitBindingData	jitBindingData
private final List<Module>	modules
private InjectorImpl.InjectorOptions	options
private InjectorImpl	parent
private PrivateElementsImpl	privateElements null unless this exists in a `private environment`
private Stage	stage

Constructor Summary

Access	Constructor and Description
pack-priv	Builder()

Method Summary

Modifier and Type	Method and Description
pack-priv void	addModules(Iterable<? extends Module> modules)
pack-priv List<InjectorShell>	build(Initializer initializer, ProcessedBindingData processedBindingData, ContinuousStopwatch stopwatch, Errors errors) Creates and returns the injector shells for the current modules.
pack-priv Stage	getStage()
pack-priv Object	lock() Synchronize on this before calling `build`.
pack-priv InjectorShell.Builder	parent(InjectorImpl parent)
pack-priv InjectorShell.Builder	privateElements(PrivateElements privateElements)
pack-priv InjectorShell.Builder	stage(Stage stage)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

bindingData	back to summary
private InjectorBindingData bindingData

elements	back to summary
private final List<Element> elements

jitBindingData	back to summary
private InjectorJitBindingData jitBindingData

modules	back to summary
private final List<Module> modules

options	back to summary
private InjectorImpl.InjectorOptions options

parent	back to summary
private InjectorImpl parent

privateElements	back to summary
private PrivateElementsImpl privateElements null unless this exists in a `private environment`

stage	back to summary
private Stage stage

Constructor Detail

Builder	back to summary
pack-priv Builder()

Method Detail

addModules	back to summary
pack-priv void addModules(Iterable<? extends Module> modules)

build	back to summary
pack-priv List<InjectorShell> build(Initializer initializer, ProcessedBindingData processedBindingData, ContinuousStopwatch stopwatch, Errors errors) Creates and returns the injector shells for the current modules. Multiple shells will be returned if any modules contain `private environments`. The primary injector will be first in the returned list.

getStage	back to summary
pack-priv Stage getStage()

lock	back to summary
pack-priv Object lock() Synchronize on this before calling `build`.

parent	back to summary
pack-priv InjectorShell.Builder parent(InjectorImpl parent)

privateElements	back to summary
pack-priv InjectorShell.Builder privateElements(PrivateElements privateElements)

stage	back to summary
pack-priv InjectorShell.Builder stage(Stage stage)

com.google.inject.internal back to summary

private Class InjectorShell.InheritedScannersModule

Class Inheritance

extends Object
implements Module

java.lang.Object
com.google.inject.internal.InjectorShell.InheritedScannersModule

All Implemented Interfaces

com.google.inject.Module

Field Summary

Modifier and Type	Field and Description
private final InjectorBindingData	bindingData

Constructor Summary

Access	Constructor and Description
pack-priv	InheritedScannersModule(InjectorBindingData bindingData)

Method Summary

Modifier and Type	Method and Description
public void	configure(Binder binder) Implements com.google.inject.Module.configure. Contributes bindings and other configurations for this module to `binder`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

bindingData	back to summary
private final InjectorBindingData bindingData

Constructor Detail

InheritedScannersModule	back to summary
pack-priv InheritedScannersModule(InjectorBindingData bindingData)

Method Detail

configure back to summary

configure	back to summary
public void configure(Binder binder) Implements com.google.inject.Module.configure. Doc from com.google.inject.Module.configure. Contributes bindings and other configurations for this module to `binder`. Do not invoke this method directly to install submodules. Instead use `Binder#install(Module)`, which ensures that `provider methods` are discovered. Annotations @Override

public void configure(Binder binder)

Implements com.google.inject.Module.configure.

Doc from com.google.inject.Module.configure.

Contributes bindings and other configurations for this module to binder.

Do not invoke this method directly to install submodules. Instead use Binder#install(Module), which ensures that provider methods are discovered.

Annotations

@Override

com.google.inject.internal back to summary

private Class InjectorShell.InjectorFactory

Class Inheritance

extends Object
implements InternalFactory<Injector>, Provider<Injector>

java.lang.Object
com.google.inject.internal.InjectorShell.InjectorFactory

All Implemented Interfaces

com.google.inject.Provider, jakarta.inject.Provider, com.google.inject.internal.InternalFactory

Field Summary

Modifier and Type	Field and Description
private final Injector	injector

Constructor Summary

Access	Constructor and Description
private	InjectorFactory(Injector injector)

Method Summary

Modifier and Type	Method and Description
public Injector	get(InternalContext of this injection context, Dependency<?> dependency, boolean true if getting as a result of a linked binding linked) Implements com.google.inject.internal.InternalFactory.get. Creates an object to be injected.
public Injector	get() Implements com.google.inject.Provider.get. Provides an instance of `T`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

injector	back to summary
private final Injector injector

Constructor Detail

InjectorFactory	back to summary
private InjectorFactory(Injector injector)

Method Detail

get	back to summary
public Injector get(InternalContext context, Dependency<?> dependency, boolean linked) Implements com.google.inject.internal.InternalFactory.get. Doc from com.google.inject.internal.InternalFactory.get. Creates an object to be injected. Parameters context:InternalContext of this injection linked:boolean true if getting as a result of a linked binding Returns:Injector instance that was created Annotations @Override

get

back to summary

public Injector get(InternalContext context, Dependency<?> dependency, boolean linked)

Implements com.google.inject.internal.InternalFactory.get.

Doc from com.google.inject.internal.InternalFactory.get.

Creates an object to be injected.

Parameters

context:InternalContext: of this injection
linked:boolean: true if getting as a result of a linked binding

Returns:Injector

instance that was created

Annotations

@Override

get back to summary

get	back to summary
public Injector get() Implements com.google.inject.Provider.get. Doc from com.google.inject.Provider.get. Provides an instance of `T`. Returns:Injector Doc from jakarta.inject.Provider.get. instance of `T`. Annotations @Override

public Injector get()

Implements com.google.inject.Provider.get.

Doc from com.google.inject.Provider.get.

Provides an instance of T.

Returns:Injector

Doc from jakarta.inject.Provider.get.

instance of T.

Annotations

@Override

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object Annotations @Override

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations

@Override

com.google.inject.internal back to summary

private Class InjectorShell.LoggerFactory

Class Inheritance

extends Object
implements InternalFactory<Logger>, Provider<Logger>

java.lang.Object
com.google.inject.internal.InjectorShell.LoggerFactory

All Implemented Interfaces

com.google.inject.Provider, jakarta.inject.Provider, com.google.inject.internal.InternalFactory

Constructor Summary

Access	Constructor and Description
private	LoggerFactory()

Method Summary

Modifier and Type	Method and Description
public Logger	get(InternalContext of this injection context, Dependency<?> dependency, boolean true if getting as a result of a linked binding linked) Implements com.google.inject.internal.InternalFactory.get. Creates an object to be injected.
public Logger	get() Implements com.google.inject.Provider.get. Provides an instance of `T`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Constructor Detail

LoggerFactory	back to summary
private LoggerFactory()

Method Detail

get	back to summary
public Logger get(InternalContext context, Dependency<?> dependency, boolean linked) Implements com.google.inject.internal.InternalFactory.get. Doc from com.google.inject.internal.InternalFactory.get. Creates an object to be injected. Parameters context:InternalContext of this injection linked:boolean true if getting as a result of a linked binding Returns:Logger instance that was created Annotations @Override

get

back to summary

public Logger get(InternalContext context, Dependency<?> dependency, boolean linked)

Implements com.google.inject.internal.InternalFactory.get.

Doc from com.google.inject.internal.InternalFactory.get.

Creates an object to be injected.

Parameters

context:InternalContext: of this injection
linked:boolean: true if getting as a result of a linked binding

Returns:Logger

instance that was created

Annotations

@Override

get back to summary

get	back to summary
public Logger get() Implements com.google.inject.Provider.get. Doc from com.google.inject.Provider.get. Provides an instance of `T`. Returns:Logger Doc from jakarta.inject.Provider.get. instance of `T`. Annotations @Override

public Logger get()

Implements com.google.inject.Provider.get.

Doc from com.google.inject.Provider.get.

Provides an instance of T.

Returns:Logger

Doc from jakarta.inject.Provider.get.

instance of T.

Annotations

@Override

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations

@Override

com.google.inject.internal back to summary

private Class InjectorShell.RootModule

Class Inheritance

extends Object
implements Module

java.lang.Object
com.google.inject.internal.InjectorShell.RootModule

All Implemented Interfaces

com.google.inject.Module

Constructor Summary

Access	Constructor and Description
private	RootModule()

Method Summary

Modifier and Type	Method and Description
public void	configure(Binder binder) Implements com.google.inject.Module.configure. Contributes bindings and other configurations for this module to `binder`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

RootModule	back to summary
private RootModule()

Method Detail

configure back to summary

public void configure(Binder binder)

Implements com.google.inject.Module.configure.

Doc from com.google.inject.Module.configure.

Contributes bindings and other configurations for this module to binder.

Do not invoke this method directly to install submodules. Instead use Binder#install(Module), which ensures that provider methods are discovered.

Annotations

@Override

pack-priv final Class InjectorShell

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class InjectorShell.Builder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class InjectorShell.InheritedScannersModule

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class InjectorShell.InjectorFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class InjectorShell.LoggerFactory

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class InjectorShell.RootModule

Constructor Summary

Method Summary

Constructor Detail

Method Detail