一、 Mapstruct简介

Mapstruct是一个Java代码生成器，专门用于对象映射。它Neng自动将一个Java Bean转换为另一个Java Bean，而无需手动编写转换逻辑。它代码、高大效无性Neng损耗等特点，广泛应用于DTO和实体对象之间的转换。

二、 Mapstruct的优势

用Mapstruct进行Java对象映射，基本上有以下优势：

• 对象映射：基本上用于DTO和实体类的相互转换，少许些再来一次代码。
• 搞优良开发效率：省去手写转换逻辑，少许些维护本钱。
• 编译时生成代码：Mapstruct在编译期生成代码，性Neng优于运行时反射。
• 可定制转换逻辑：允许手动定义映射规则，比如字段映射、类型转换等。
• 支持Spring依赖注入：Neng和Spring结合，映射器实例。

三、 配置Maven插件

在pom.xml文件中添加Mapstruct的Maven插件，以在编译时自动生成映射器代码：

    
        org.mapstruct
        mapstruct-jdk8
        ..Final
    

    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            .
            
                
                
                
                    
                        org.mapstruct
                        mapstruct-processor
                        ..Final
                    
                
            
        
    

四、定义映射器接口

创建一个接口，用MapStruct注解定义映射关系和转换规则：

@Mapper
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper;
    @Mapping
    @Mapping
    @Mapping
    @Mapping
    CarDTO carToCarDTO;
}

五、用@CollectionMapping注解

在@CollectionMapping注解中，通过用@IterableMapping或者@MapMapping注解Neng设置集合属性的默认值：

    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            .
            
                
                
                
                    
                        org.mapstruct
                        mapstruct-processor
                        ..Final
                    
                
            
        
    

六、用@Mappings注解

@Mappings注解用于集中配置常用的@Mapping注解规则，以避免在个个映射器中dou再来一次编写单个规则：

@Mapper
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper;
    @Mappings({
        @Mapping,
        @Mapping,
        @Mapping
    })
    CarDTO carToCarDTO;
}

七、Spring Boot配置生命周期回调

在Spring Boot应用程序中用Mapstruct时Neng实现映射器接口上的SpringBean映射，用@PostConstruct启动映射器：

@Mapper
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper;
    @PostConstruct
    default void init {
        // Do Some initialization work
    }
    ...
}

八、Mapstruct设置默认值

一、用@DefaultValue注解

Neng用@DefaultValue注解在源Bean属性为空时设置默认值：

@Mapper
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper;
    @Mapping
    CarDTO carToCarDTO;
    List carsToCarDTOs;
}

二、用@MapperConfig注解

Neng在用@Mapper注解的类上用@MapperConfig注解设置映射器的通用配置，从而省略个个映射器的相同再来一次代码：

public class CarService {
    public CarDTO getCarById {
        Car car = carDao.getCarById;
        return CarMapper.INSTANCE.carToCarDTO;
    }
}

九、Mapstruct原理

Mapstruct是Java映射器实现属性映射的。它的干活原理如下：

1. 定义映射器接口，用@Mapper注解标记。

2. 在映射器接口中，用@Mapping注解定义源对象与目标对象之间的映射关系。

3. Mapstruct会扫描全部用@Mapper注解的接口，然后自动生成Java代码来实现这些个接口。

4. 生成代码包括源Bean和目标Bean之间属性的映射代码。

5. 在编译期间，生成的代码会被编译成字节码，并在运行时施行映射操作。