MapStruct是一个用于生成类型安全,高性能和无依赖的bean映射代码的注释处理器
简介
MapStruct是一个Java 注释处理器,用于生成类型安全的bean映射类。
需要做的就是定义一个mapper接口,该接口声明任何所需的映射方法。在编译期间,MapStruct将生成此接口的实现。此实现使用普通的Java方法调用来在源对象和目标对象之间进行映射,即没有反射或类似。
与手工编写映射代码相比,MapStruct通过生成繁琐且易于编写的代码来节省时间。遵循约定优于配置方法,MapStruct使用合理的默认值,但在配置或实现特殊行为时会采取措施。
与动态映射框架相比,MapStruct具有以下优势:
- 通过使用普通方法调用而不是反射来快速执行
- 编译时类型安全:只能映射相互映射的对象和属性,不会将订单实体意外映射到客户DTO等。
- 在构建时清除错误报告,如果 映射不完整(并非所有目标属性都已映射) 映射不正确(找不到合适的映射方法或类型转换)
MapStruct 支持JVM相关的编程语言如Scala ,Kotlin ,Lvy,Groovy Grape等
依赖
包含Mapping注释
Maven
org.mapstruct mapstruct 1.3.1.Final
Gradle
implementation 'org.mapstruct:mapstruct:1.3.1.Final'
processor 依赖
org.mapstruct mapstruct-processor 1.3.1.Final
下载情况
IntelliJ IDEA 插件
在plugins中搜索‘mapstruct’
processor 注解处理器中的选项
...1.3.1.Final...org.mapstruct mapstruct ${org.mapstruct.version}...org.apache.maven.plugins maven-compiler-plugin 3.5.11.81.8org.mapstruct mapstruct-processor ${org.mapstruct.version} -Amapstruct.suppressGeneratorTimestamp=true -Amapstruct.suppressGeneratorVersionInfoComment=true
检索映射器
实战
public class Car { private String make; private int numberOfSeats; private CarType type; //constructor, getters, setters etc.}
public class CarDto { private String make; private int seatCount; private String type; //constructor, getters, setters etc.}
配置Mapping
@Mapper public interface CarMapper { CarMapper INSTANCE = Mappers.getMapper( CarMapper.class ); 3 @Mapping(source = "numberOfSeats", target = "seatCount") CarDto carToCarDto(Car car); 2}
总结
类似转换的工具还有一些,大家可以比对下。根据自身的需求选择合适的实现方式。