Mapstruct官方参考文档中的一些使用规则

Mapstruct官方参考文档中的一些使用规则

在mapstruct中自定义转换方法

引入依赖

<dependency>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct</artifactId>
            <version>1.3.1.Final</version>
        </dependency>
        <dependency>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct-processor</artifactId>
            <version>1.3.1.Final</version>
        </dependency>


<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

写转换接口

有些转换我们不能通过mapstruct自动完成，那么我们可以自定义转换方法，自己写转换规则，如下图：

接口中需要写一个实例属性，也就是INSTANCE,这样我们通过INSTANCE得到的PeriodCopier接口，在运行的时候其实就变成了它的实现类PeriodCopierImpl,这个实现类是在运行的时候，idea自动生成的。

写完转换接口之后，我们程序在运行的时候，会自动生成这个接口的实现类，如下图：

测试

我们调用的接口实例，在运行的时候其实会通过反射调用自动生成的实现类PeriodCopierImpl。

官网

官网地址：

https://mapstruct.org/documentation/stable/reference/html/

官网描述如下图：

将多个源对象的不同属性赋值给一个目标对象

官网地址：https://mapstruct.org/documentation/stable/reference/html/#mappings-with-several-source-parameters

官方参考指南中的详细说明，如下图：

如果mapstruct放到了IOC容器里面，那么就不要实例化对象

实例化获取对象的方式

mapstruct生成对象的方式有两种，第一种是直接实例化，如下图：

在后续代码中如果想要获取mapstruct实例，直接CarMapper.INSTANCE就可以获取到，这是实例化的方式获取到mapstruct对象；

从SpringIOC容器中获取对象

如果我们把mapstruct放到了SpringIOC容器中，那么我们就不要在实例化对象了，这相当于是new了一个对象，后续会出空指针问题的，因为我们已经把mapstruct对象放到IOC容器中了，所以它内部的很多东西都是在IOC容器中直接取到的，但是我们创建mapstruct对象的时候却不是从IOC容器里面获取的，而是直接new的，这会出现什么问题呢？就是虽然你创建了mapstruct对象，但是它里面的很多东西会出现null空指针错误。

@Mapper加上参数后，即@Mapper(componentModel = “spring”)就表示把mapstuct放到了IOC容器中。

那么我们后续再生成mapstuct对象的时候，要直接从IOC容器里面引入，即使用@Resource注解或者是@Autowire注解。

源对象中的对象属性怎么转化成目标对象中的对象属性？

源对象Period中的对象属性，如下图：

目标对象PeriodVO中的对象属性，如下图：

Student对象的属性，如下图：

StudentVO对象的属性如下图：

mapsruct中通过bean的嵌套来进行属性映射，如下图：

测试，如下图：