mapstruct/mapstruct
Mapstruct
MapStruct is an annotation processor and Java bean mapping framework that automatically generates high-performance data transfer code during the compilation process. It serves as a type-safe data mapper for converting information between different object types, specifically targeting Java beans and records.
The project replaces manual boilerplate code by using Java interfaces as blueprints to generate concrete implementation classes. This approach ensures type safety and minimizes manual getter and setter calls by producing direct method calls during compilation.
The framework handles data transformation across built-in types and includes automated null safety checks. It analyzes nullness annotations to insert guards and assign default values when transferring data between API models and internal entities.
Features
- Type-Safe Mapper Generators - Creates mapping code between bean types and records at compile time to ensure type safety.
- Annotation Processing Tooling - Integrates with the Java Annotation Processing Tool to produce implementation classes during the build lifecycle.
- Java Annotation Processors - Implements a Java annotation processor to generate mapping code during the compilation process.
- Compile-Time Field Mapping - Resolves field-to-field mapping and type conversions during compilation to avoid runtime reflection.
- Interface-Driven Design Patterns - Uses Java interfaces as blueprints to automatically generate concrete mapping implementation classes.
- Type-Safe Data Handling - Creates reliable mapping layers between API models and internal entities while maintaining compile-time type checks.
- Boilerplate Reduction Patterns - Eliminates the need for manual getter and setter calls by generating mapping logic during compilation.
- Direct Method Call Generation - Produces plain Java method calls for data transfer to maximize execution speed and type safety.
- Null Value Validation - Inserts guards and assigns default values by analyzing nullness annotations during data mapping.
- Null-Aware Code Generation - Analyzes nullness annotations to automatically insert null checks and default value logic into generated methods.
- Null-Safe Object Mapping - Handles potential null values and default assignments automatically when transferring data between object types.
- Bean Mapping - Code generator for convention-over-configuration bean mapping.
- Bean Mapping and Validation - Annotation processor for generating type-safe bean mappers.
