# google/guice architecture

> Architecture diagram of the GitHub repository google/guice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/guice
- Repository: https://github.com/google/guice

## Overview

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: [`core/src/com/google/inject/Injector.java`](https://github.com/google/guice/blob/master/core/src/com/google/inject/Injector.java) (Injector API), [`core/src/com/google/inject/Binder.java`](https://github.com/google/guice/blob/master/core/src/com/google/inject/Binder.java) (Binding DSL), [`core/src/com/google/inject/internal/InjectorImpl.java`](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InjectorImpl.java) (Injector Engine), [`core/src/com/google/inject/internal/ConstructorBindingImpl.java`](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/ConstructorBindingImpl.java) (Constructor Provision)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public Configuration"]
  node_module["Module Configuration<br/>[Module.java]"]
  node_binder["Binding DSL<br/>[Binder.java]"]
  node_guice["Injector Factory<br/>[Guice.java]"]
  node_injector["Injector API<br/>[Injector.java]"]
end

subgraph group_runtime["Injector Runtime"]
  node_creator["Injector Creator"]
  node_shell["Injector Shell<br/>[InjectorShell.java]"]
  node_binding_processor["Binding Processor"]
  node_injector_impl["Injector Engine<br/>[InjectorImpl.java]"]
  node_constructor_binding["Constructor Provision"]
  node_members_injector["Members Injection"]
  node_scope["Scope Management<br/>[Scoping.java]"]
  node_errors["Error Reporting<br/>[ErrorHandler.java]"]
  node_aop["AOP Generation<br/>[BytecodeTasks.java]"]
end

subgraph group_extensions["Framework Extensions"]
  node_multibindings["Multibindings<br/>[Multibinder.java]"]
  node_assisted["Assisted Factories"]
  node_servlet_filter["Servlet Filter<br/>[GuiceFilter.java]"]
  node_filter_pipeline["Filter Pipeline"]
  node_servlet_pipeline["Servlet Pipeline"]
  node_persist["JPA Persistence"]
end

subgraph group_observability["Instrumentation"]
  node_jmx["JMX Manager<br/>[Manager.java]"]
  node_grapher["Injector Grapher"]
end

node_app(("Java Application"))
node_servlet_container(("Servlet Container"))
node_jpa_provider["JPA Provider"]
node_mbean_server["MBean Server"]
node_application_object["Injected Instance"]

node_app -->|"defines modules"| node_module
node_app -->|"creates injector"| node_guice
node_module -->|"configures bindings"| node_binder
node_binder -->|"supplies configuration"| node_guice
node_guice -->|"creates injector"| node_creator
node_creator -->|"builds shells"| node_shell
node_shell -->|"processes elements"| node_binding_processor
node_binding_processor -->|"installs bindings"| node_injector_impl
node_injector_impl -->|"exposes API"| node_injector
node_injector -->|"resolves constructors"| node_constructor_binding
node_constructor_binding -->|"injects members"| node_members_injector
node_injector_impl -->|"applies scopes"| node_scope
node_injector_impl -->|"reports failures"| node_errors
node_constructor_binding -.->|"generates proxies"| node_aop
node_binder -->|"configures collections"| node_multibindings
node_binder -->|"configures factories"| node_assisted
node_servlet_container -->|"sends requests"| node_servlet_filter
node_servlet_filter -->|"dispatches requests"| node_filter_pipeline
node_filter_pipeline -->|"delegates servlets"| node_servlet_pipeline
node_servlet_pipeline -->|"resolves definitions"| node_injector
node_app -->|"starts persistence"| node_persist
node_persist -->|"creates factory"| node_jpa_provider
node_app -.->|"enables management"| node_jmx
node_jmx -->|"reads bindings"| node_injector
node_jmx -->|"registers MBeans"| node_mbean_server
node_app -.->|"requests graph"| node_grapher
node_grapher -->|"inspects bindings"| node_injector
node_injector -->|"returns instance"| node_application_object

click node_module "https://github.com/google/guice/blob/master/core/src/com/google/inject/Module.java"
click node_binder "https://github.com/google/guice/blob/master/core/src/com/google/inject/Binder.java"
click node_guice "https://github.com/google/guice/blob/master/core/src/com/google/inject/Guice.java"
click node_injector "https://github.com/google/guice/blob/master/core/src/com/google/inject/Injector.java"
click node_creator "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InternalInjectorCreator.java"
click node_shell "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InjectorShell.java"
click node_binding_processor "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/BindingProcessor.java"
click node_injector_impl "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InjectorImpl.java"
click node_constructor_binding "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/ConstructorBindingImpl.java"
click node_members_injector "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/MembersInjectorImpl.java"
click node_scope "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/Scoping.java"
click node_errors "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/ErrorHandler.java"
click node_aop "https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/aop/BytecodeTasks.java"
click node_multibindings "https://github.com/google/guice/blob/master/core/src/com/google/inject/multibindings/Multibinder.java"
click node_assisted "https://github.com/google/guice/blob/master/extensions/assistedinject/src/com/google/inject/assistedinject/FactoryModuleBuilder.java"
click node_servlet_filter "https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/GuiceFilter.java"
click node_filter_pipeline "https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/ManagedFilterPipeline.java"
click node_servlet_pipeline "https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/ManagedServletPipeline.java"
click node_persist "https://github.com/google/guice/blob/master/extensions/persist/src/com/google/inject/persist/jpa/JpaPersistService.java"
click node_jmx "https://github.com/google/guice/blob/master/extensions/jmx/src/com/google/inject/tools/jmx/Manager.java"
click node_grapher "https://github.com/google/guice/blob/master/extensions/grapher/src/com/google/inject/grapher/AbstractInjectorGrapher.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_module,node_binder,node_guice,node_injector toneBlue
class node_creator,node_shell,node_binding_processor,node_injector_impl,node_constructor_binding,node_members_injector,node_scope,node_errors,node_aop toneAmber
class node_multibindings,node_assisted,node_servlet_filter,node_filter_pipeline,node_servlet_pipeline,node_persist,node_mbean_server toneMint
class node_jmx,node_grapher toneRose
class node_app,node_servlet_container,node_jpa_provider,node_application_object toneIndigo
```

## Components

### Public Configuration

- [Module Configuration](https://github.com/google/guice/blob/master/core/src/com/google/inject/Module.java): `core/src/com/google/inject/Module.java`
- [Binding DSL](https://github.com/google/guice/blob/master/core/src/com/google/inject/Binder.java): `core/src/com/google/inject/Binder.java`
- [Injector Factory](https://github.com/google/guice/blob/master/core/src/com/google/inject/Guice.java): `core/src/com/google/inject/Guice.java`
- [Injector API](https://github.com/google/guice/blob/master/core/src/com/google/inject/Injector.java): `core/src/com/google/inject/Injector.java`

### Injector Runtime

- [Injector Creator](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InternalInjectorCreator.java): `core/src/com/google/inject/internal/InternalInjectorCreator.java`
- [Injector Shell](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InjectorShell.java): `core/src/com/google/inject/internal/InjectorShell.java`
- [Binding Processor](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/BindingProcessor.java): `core/src/com/google/inject/internal/BindingProcessor.java`
- [Injector Engine](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/InjectorImpl.java): `core/src/com/google/inject/internal/InjectorImpl.java`
- [Constructor Provision](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/ConstructorBindingImpl.java): `core/src/com/google/inject/internal/ConstructorBindingImpl.java`
- [Members Injection](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/MembersInjectorImpl.java): `core/src/com/google/inject/internal/MembersInjectorImpl.java`
- [Scope Management](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/Scoping.java): `core/src/com/google/inject/internal/Scoping.java`
- [Error Reporting](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/ErrorHandler.java): `core/src/com/google/inject/internal/ErrorHandler.java`
- [AOP Generation](https://github.com/google/guice/blob/master/core/src/com/google/inject/internal/aop/BytecodeTasks.java): `core/src/com/google/inject/internal/aop/BytecodeTasks.java`

### Framework Extensions

- [Multibindings](https://github.com/google/guice/blob/master/core/src/com/google/inject/multibindings/Multibinder.java): `core/src/com/google/inject/multibindings/Multibinder.java`
- [Assisted Factories](https://github.com/google/guice/blob/master/extensions/assistedinject/src/com/google/inject/assistedinject/FactoryModuleBuilder.java): `extensions/assistedinject/src/com/google/inject/assistedinject/FactoryModuleBuilder.java`
- [Servlet Filter](https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/GuiceFilter.java): `extensions/servlet/src/com/google/inject/servlet/GuiceFilter.java`
- [Filter Pipeline](https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/ManagedFilterPipeline.java): `extensions/servlet/src/com/google/inject/servlet/ManagedFilterPipeline.java`
- [Servlet Pipeline](https://github.com/google/guice/blob/master/extensions/servlet/src/com/google/inject/servlet/ManagedServletPipeline.java): `extensions/servlet/src/com/google/inject/servlet/ManagedServletPipeline.java`
- [JPA Persistence](https://github.com/google/guice/blob/master/extensions/persist/src/com/google/inject/persist/jpa/JpaPersistService.java): `extensions/persist/src/com/google/inject/persist/jpa/JpaPersistService.java`

### Instrumentation

- [JMX Manager](https://github.com/google/guice/blob/master/extensions/jmx/src/com/google/inject/tools/jmx/Manager.java): `extensions/jmx/src/com/google/inject/tools/jmx/Manager.java`
- [Injector Grapher](https://github.com/google/guice/blob/master/extensions/grapher/src/com/google/inject/grapher/AbstractInjectorGrapher.java): `extensions/grapher/src/com/google/inject/grapher/AbstractInjectorGrapher.java`

### Other components

- **Java Application**
- **Servlet Container**
- **JPA Provider**
- **MBean Server**
- **Injected Instance**

## Connections

- 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
