MapStruct到底是什么? MapStruct到底是什么?

一、简介现在的分布式系统中模块划分越来越细，不同模块的实体、DTO、DO等需要进行转换，这么多工程处理起来不是那么简单。
MapStruct 就是这样的一个属性映射插件，用于为Java Bean生成类型安全且高性能的映射。它基于编译阶段生成get/set代码，此实现过程中没有反射，不会造成额外的性能损失。只需要定义一个 Mapper 接口，MapStruct 就会自动实现这个映射接口，避免了繁琐的映射实现。
官网 - 官方示例
优点
与手工编写映射代码相比

MapStruct通过生成冗长且容易出错的代码来节省时间。

与动态映射框架相比

简单泛型智能转换；
效率高：无需手动 set/get 或 implements Serializable 以达到深拷贝；
性能更高：使用简单的 Java 方法调用代替反射；
编译时类型安全：只能映射相同名称或带映射标记的属性；
编译时产生错误报告：如果映射不完整（存在未被映射的目标属性）或映射不正确（找不到合适的映射方法或类型转换）则会在编译时抛出异常。

文章图片

二、Demo 2.1 导入依赖
使用该插件主要需要导入两个包：
::: details Maven | Gradle
Maven

org.mapstructmapstruct-jdk81.3.0.Finalorg.mapstructmapstruct-processor1.3.0.Final

Gradle

plugins {...id "com.diffplug.eclipse.apt" version "3.26.0" // Only for Eclipse}dependencies {...compile 'org.mapstruct:mapstruct:1.4.2.Final'annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'testAnnotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final' // if you are using mapstruct in test code}...

2.2 示例代码
::: details domain、vo、mapper、controller
domain/Person.java

@Data@Builder@NoArgsConstructor@AllArgsConstructorpublic class Person {private Long id; private String name; private Integer age; private Integer sex; }

vo/PersonVO.java

@Data@Builder@NoArgsConstructor@AllArgsConstructorpublic class PersonVO {private Long personId; private String personName; private Integer age; }

mapper/PersonMapper.java

@Mapper(componentModel = "spring")public interface PersonMapper {/*** ClassLoader 的方式获取当前 mapper （可以不用）*/PersonMapper INSTANCE = Mappers.getMapper(PersonMapper.class); /*** 实体转VO* source* @param person* @return PersonVO*/@Mappings({@Mapping(source = "id", target = "personId"),@Mapping(source = "name", target = "personName")})PersonVO toPersonVO(Person person); /*** VO转实体** @param person* @return PersonVO*/@Mappings({@Mapping(source = "personId", target = "id"),@Mapping(source = "personName", target = "name"),@Mapping(target = "sex", ignore = true),})Person toPerson(PersonVO person); }

Controller