# projectlombok/lombok architecture

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

- Interactive diagram: https://gitdiagram.com/projectlombok/lombok
- Repository: https://github.com/projectlombok/lombok

## Overview

Lombok is a Java library that uses annotations and compiler integrations to generate boilerplate in user code. The principal workflow runs from annotated Java source through compiler-specific processing to transformed code; the repository also includes Eclipse integration, bytecode post-processing, source expansion via delombok, and IDE installation. The graph uses README statements and SOURCE INDEX references for supported links; dashed links mark workflow steps whose implementation was not shown in the excerpts.

Main entry points: [`src/core/lombok/javac/apt/LombokProcessor.java`](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/apt/LombokProcessor.java) (Javac Processor), [`src/core/lombok/javac/HandlerLibrary.java`](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/HandlerLibrary.java) (Javac Handler Registry), [`src/core/lombok/javac/handlers/HandleData.java`](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/handlers/HandleData.java) (Javac Handlers), [`src/core/lombok/eclipse/HandlerLibrary.java`](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/eclipse/HandlerLibrary.java) (Eclipse Handler Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Annotation API"]
  node_annotations["Lombok Annotations<br/>[Data.java]"]
end

subgraph group_processing["Compiler Processing"]
  node_config["Configuration"]
  node_javac_processor["Javac Processor"]
  node_javac_handlers["Javac Handlers<br/>[HandleData.java]"]
  node_javac_util["Javac Utilities"]
  node_ast["Shared AST Model<br/>[AST.java]"]
  node_type_resolver["Type Resolution<br/>[TypeResolver.java]"]
  node_handler_library["Javac Handler Registry"]
end

subgraph group_eclipse["Eclipse Integration"]
  node_eclipse_handlers["Eclipse Handlers<br/>[HandleData.java]"]
  node_eclipse_library["Eclipse Handler Registry"]
  node_eclipse_agent["Eclipse Agent Patches"]
end

subgraph group_tools["Source And Bytecode Tools"]
  node_postcompiler["Bytecode Post-Compiler<br/>[PostCompiler.java]"]
  node_delombok["Delombok<br/>[Delombok.java]"]
  node_installer["IDE Installer<br/>[Installer.java]"]
end

node_developer(("Java Developer"))
node_javac["Java Compiler"]
node_generated_code["Transformed Code"]

node_developer -->|"adds annotations"| node_annotations
node_annotations -.->|"processed during compilation"| node_javac_processor
node_javac -.->|"invokes processor"| node_javac_processor
node_javac_processor -.->|"dispatches handlers"| node_handler_library
node_handler_library -->|"uses utilities"| node_javac_util
node_handler_library -->|"resolves types"| node_type_resolver
node_javac_handlers -.->|"uses utilities"| node_javac_util
node_javac_handlers -.->|"generates members"| node_generated_code
node_javac_processor -.->|"reads settings"| node_config
node_eclipse_library -.->|"dispatches handlers"| node_eclipse_handlers
node_eclipse_library -->|"resolves types"| node_type_resolver
node_eclipse_agent -.->|"supports compiler patches"| node_eclipse_handlers
node_javac_processor -.->|"may post-process"| node_postcompiler
node_developer -.->|"expands annotations"| node_delombok
node_developer -.->|"installs IDE integration"| node_installer

click node_annotations "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/Data.java"
click node_config "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/configuration/NullAnnotationLibrary.java"
click node_javac_processor "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/apt/LombokProcessor.java"
click node_javac_handlers "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/handlers/HandleData.java"
click node_javac_util "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/handlers/JavacHandlerUtil.java"
click node_ast "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/AST.java"
click node_type_resolver "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/TypeResolver.java"
click node_handler_library "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/HandlerLibrary.java"
click node_eclipse_handlers "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/eclipse/handlers/HandleData.java"
click node_eclipse_library "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/eclipse/HandlerLibrary.java"
click node_eclipse_agent "https://github.com/projectlombok/lombok/blob/master/src/eclipseAgent/lombok/launch/PatchFixesHider.java"
click node_postcompiler "https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/PostCompiler.java"
click node_delombok "https://github.com/projectlombok/lombok/blob/master/src/delombok/lombok/delombok/Delombok.java"
click node_installer "https://github.com/projectlombok/lombok/blob/master/src/installer/lombok/installer/Installer.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_annotations toneBlue
class node_config,node_javac_processor,node_javac_handlers,node_javac_util,node_ast,node_type_resolver,node_handler_library toneAmber
class node_eclipse_handlers,node_eclipse_library,node_eclipse_agent toneMint
class node_postcompiler,node_delombok,node_installer toneRose
class node_developer,node_javac,node_generated_code toneIndigo
```

## Components

### Annotation API

- [Lombok Annotations](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/Data.java): `src/core/lombok/Data.java`

### Compiler Processing

- [Configuration](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/configuration/NullAnnotationLibrary.java): `src/core/lombok/core/configuration/NullAnnotationLibrary.java`
- [Javac Processor](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/apt/LombokProcessor.java): `src/core/lombok/javac/apt/LombokProcessor.java`
- [Javac Handlers](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/handlers/HandleData.java): `src/core/lombok/javac/handlers/HandleData.java`
- [Javac Utilities](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/handlers/JavacHandlerUtil.java): `src/core/lombok/javac/handlers/JavacHandlerUtil.java`
- [Shared AST Model](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/AST.java): `src/core/lombok/core/AST.java`
- [Type Resolution](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/TypeResolver.java): `src/core/lombok/core/TypeResolver.java`
- [Javac Handler Registry](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/javac/HandlerLibrary.java): `src/core/lombok/javac/HandlerLibrary.java`

### Eclipse Integration

- [Eclipse Handlers](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/eclipse/handlers/HandleData.java): `src/core/lombok/eclipse/handlers/HandleData.java`
- [Eclipse Handler Registry](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/eclipse/HandlerLibrary.java): `src/core/lombok/eclipse/HandlerLibrary.java`
- [Eclipse Agent Patches](https://github.com/projectlombok/lombok/blob/master/src/eclipseAgent/lombok/launch/PatchFixesHider.java): `src/eclipseAgent/lombok/launch/PatchFixesHider.java`

### Source And Bytecode Tools

- [Bytecode Post-Compiler](https://github.com/projectlombok/lombok/blob/master/src/core/lombok/core/PostCompiler.java): `src/core/lombok/core/PostCompiler.java`
- [Delombok](https://github.com/projectlombok/lombok/blob/master/src/delombok/lombok/delombok/Delombok.java): `src/delombok/lombok/delombok/Delombok.java`
- [IDE Installer](https://github.com/projectlombok/lombok/blob/master/src/installer/lombok/installer/Installer.java): `src/installer/lombok/installer/Installer.java`

### Other components

- **Java Developer**
- **Java Compiler**
- **Transformed Code**

## Connections

- Java Developer → Lombok Annotations: adds annotations
- Lombok Annotations → Javac Processor: processed during compilation
- Java Compiler → Javac Processor: invokes processor
- Javac Processor → Javac Handler Registry: dispatches handlers
- Javac Handler Registry → Javac Utilities: uses utilities (evidence: `src/core/lombok/javac/HandlerLibrary.java`)
- Javac Handler Registry → Type Resolution: resolves types (evidence: `src/core/lombok/javac/HandlerLibrary.java`)
- Javac Handlers → Javac Utilities: uses utilities
- Javac Handlers → Transformed Code: generates members
- Javac Processor → Configuration: reads settings
- Eclipse Handler Registry → Eclipse Handlers: dispatches handlers
- Eclipse Handler Registry → Type Resolution: resolves types (evidence: `src/core/lombok/eclipse/HandlerLibrary.java`)
- Eclipse Agent Patches → Eclipse Handlers: supports compiler patches (evidence: `src/eclipseAgent/lombok/launch/PatchFixesHider.java`)
- Javac Processor → Bytecode Post-Compiler: may post-process
- Java Developer → Delombok: expands annotations
- Java Developer → IDE Installer: installs IDE integration
