How google/guice works
Guice is a Java dependency-injection framework. An application supplies modules and bindings, Guice builds an injector, and the injector resolves keys by constructing or providing objects, injecting constructors and members, applying scopes, and returning usable instances. The graph also preserves major extension branches: servlet request dispatch, JPA persistence, assisted factories, multibindings, AOP, graphing, and JMX management. Some extension relationships are represented from directory structure and documented APIs; unsampled implementation details are intentionally omitted.
Main entry points: Injector.java Injector API · Binder.java Binding DSL · InjectorImpl.java Injector Engine · ConstructorBindingImpl.java Constructor Provision
Components 26
Public Configuration
- Module Configuration
core/src/com/google/inject/Module.java - Binding DSL
core/src/com/google/inject/Binder.java - Injector Factory
core/src/com/google/inject/Guice.java - Injector API
core/src/com/google/inject/Injector.java
Injector Runtime
- Injector Creator
core/src/com/google/inject/internal/InternalInjectorCreator.java - Injector Shell
core/src/com/google/inject/internal/InjectorShell.java - Binding Processor
core/src/com/google/inject/internal/BindingProcessor.java - Injector Engine
core/src/com/google/inject/internal/InjectorImpl.java - Constructor Provision
core/src/com/google/inject/internal/ConstructorBindingImpl.java - Members Injection
core/src/com/google/inject/internal/MembersInjectorImpl.java - Scope Management
core/src/com/google/inject/internal/Scoping.java - Error Reporting
core/src/com/google/inject/internal/ErrorHandler.java - AOP Generation
core/src/com/google/inject/internal/aop/BytecodeTasks.java
Framework Extensions
- Multibindings
core/src/com/google/inject/multibindings/Multibinder.java - Assisted Factories
extensions/assistedinject/src/com/google/inject/assistedinject/FactoryModuleBuilder.java - Servlet Filter
extensions/servlet/src/com/google/inject/servlet/GuiceFilter.java - Filter Pipeline
extensions/servlet/src/com/google/inject/servlet/ManagedFilterPipeline.java - Servlet Pipeline
extensions/servlet/src/com/google/inject/servlet/ManagedServletPipeline.java - JPA Persistence
extensions/persist/src/com/google/inject/persist/jpa/JpaPersistService.java
Instrumentation
- JMX Manager
extensions/jmx/src/com/google/inject/tools/jmx/Manager.java - Injector Grapher
extensions/grapher/src/com/google/inject/grapher/AbstractInjectorGrapher.java
Other components
- Java Application
- Servlet Container
- JPA Provider
- MBean Server
- Injected Instance
Connections 28
- Java Application → Module Configuration: defines modules
- Java Application → Injector Factory: creates injector
- Module Configuration → Binding DSL: configures bindings
- Binding DSL → Injector Factory: supplies configuration
- Injector Factory → Injector Creator: creates injector
- Injector Creator → Injector Shell: builds shells
- Injector Shell → Binding Processor: processes elements
- Binding Processor → Injector Engine: installs bindings
- Injector Engine → Injector API: exposes API
- Injector API → Constructor Provision: resolves constructors
- Constructor Provision → Members Injection: injects members
- Injector Engine → Scope Management: applies scopes
- Injector Engine → Error Reporting: reports failures
- Constructor Provision → AOP Generation: generates proxies
- Binding DSL → Multibindings: configures collections
- Binding DSL → Assisted Factories: configures factories
- Servlet Container → Servlet Filter: sends requests
- Servlet Filter → Filter Pipeline: dispatches requests
- Filter Pipeline → Servlet Pipeline: delegates servlets
- Servlet Pipeline → Injector API: resolves definitions
- Java Application → JPA Persistence: starts persistence
- JPA Persistence → JPA Provider: creates factory
- Java Application → JMX Manager: enables management
- JMX Manager → Injector API: reads bindings
- JMX Manager → MBean Server: registers MBeans
- Java Application → Injector Grapher: requests graph
- Injector Grapher → Injector API: inspects bindings
- Injector API → Injected Instance: returns instance