Google Guice (pronounced "juice") is an ultra-lightweight dependency injection framework. Please refer to the Guice User's Guide for a gentle introduction.
The principal public APIs in this package are:
- The annotation you will use in your implementation classes to tell Guice where and how it should send in ("inject") the objects you depend on (your "dependencies").
- The interface you will implement in order to specify "bindings" -- instructions for how Guice should handle injection -- for a particular set of interfaces.
- The object that Guice passes into your
Moduleto collect these bindings.
- The interface you will implement when you need to customize exactly how Guice creates instances for a particular binding.
ClassDescriptionA support class for
Modules which reduces repetition and results in a more readable configuration.Collects configuration information (primarily bindings) which will be used to create an
Injector.Binding<T>A mapping from a key (type and optional annotation) to the strategy for getting instances of the type.Annotates annotations which are used for binding.Thrown when a programming error such as a misplaced annotation, illegal binding, or unsupported scope is found.Thrown when errors occur while creating a
Injector.Accompanies a @
Providesmethod annotation in a private module to indicate that the provided binding is exposed.The entry point to the Guice framework.A pointer to the default implementation of a type.Annotates members of your implementation class (constructors, methods and fields) into which the
Injectorshould inject values.Builds the graphs of objects that make up your application.Key<T>Binding key consisting of an injection type and an optional annotation.Injects dependencies into the fields and methods on instances of type
T.A module contributes configuration information, typically interface bindings, which will be used to create an
Provider.get()when an attempt is made to access a scoped object while the scope in question is not currently active.A module can implement this interface to allow to pre process other modules before an injector is created.Returns a binder whose configuration information is hidden from its environment by default.A module whose configuration information is hidden from its environment by default.A pointer to the default provider type for a type.Provider<T>An object capable of providing instances of type
T.Annotates methods of a
Moduleto create a provider method binding.Indicates that there was a runtime failure while providing an instance.A scope is a level of visibility that instances provided by Guice may have.Annotates annotations which are used for scoping.Built-in scope implementations.Apply this to implementation classes when you want only one instance (per
Injector) to be reused for all injections for that binding.The stage we're running in.TypeLiteral<T>Represents a generic type