How projectlombok/lombok works
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: LombokProcessor.java Javac Processor · javac/HandlerLibrary.java Javac Handler Registry · HandleData.java Javac Handlers · eclipse/HandlerLibrary.java Eclipse Handler Registry
Components 17
Annotation API
- Lombok Annotations
src/core/lombok/Data.java
Compiler Processing
- Configuration
src/core/lombok/core/configuration/NullAnnotationLibrary.java - Javac Processor
src/core/lombok/javac/apt/LombokProcessor.java - Javac Handlers
src/core/lombok/javac/handlers/HandleData.java - Javac Utilities
src/core/lombok/javac/handlers/JavacHandlerUtil.java - Shared AST Model
src/core/lombok/core/AST.java - Type Resolution
src/core/lombok/core/TypeResolver.java - Javac Handler Registry
src/core/lombok/javac/HandlerLibrary.java
Eclipse Integration
- Eclipse Handlers
src/core/lombok/eclipse/handlers/HandleData.java - Eclipse Handler Registry
src/core/lombok/eclipse/HandlerLibrary.java - Eclipse Agent Patches
src/eclipseAgent/lombok/launch/PatchFixesHider.java
Source And Bytecode Tools
- Bytecode Post-Compiler
src/core/lombok/core/PostCompiler.java - Delombok
src/delombok/lombok/delombok/Delombok.java - IDE Installer
src/installer/lombok/installer/Installer.java
Other components
- Java Developer
- Java Compiler
- Transformed Code
Connections 15
- 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
src/core/lombok/javac/HandlerLibrary.java - Javac Handler Registry → Type Resolution: resolves types
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
src/core/lombok/eclipse/HandlerLibrary.java - Eclipse Agent Patches → Eclipse Handlers: supports compiler patches
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