工程师工具箱系列（1）MapStruct

工程师工具箱系列（1）MapStruct

芸芸众生

在Java项目开发中，不管你是采用传统的MVC分层模式，还是DDD驱动的微服务模式，都免不了在各层级之间传递对象，在这个过程中会出现许多的对象概念性名词：VO，DTO，DO，Entity，ValueObj等等。我们先不管这些对象在你们各自项目里的作用，有一个共同的工作就是完成他们之间赋值转换。

靠手动赋值来完成对象转换的人毕竟已经很稀缺了，我们一般都知道借助一些工具去简化这部分重复劳动。

目前市面上用的比较常见的可能有下面这几种：

它们之间的性能对比大致如下：

结合性能和吞吐量来看，手动写性能肯定是最高的，省去中间商赚差价嘛，但是社会有分工才能进步，整体效能才能增加，所以我们应该借助工具。

综合分析下来，MapStruct的性能和吞吐量都是最好的，毕竟实现原理上决定了一切，接下来我们就上手下MapStruct。

初窥门径

mapstruct的使用和如何把大象放进冰箱的步骤是一样的：1 引入mapstruct；2 创建转换器与转换方法；3 获取转换实例进行使用

引入POM依赖

Maven

<dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${org.mapstruct.version}</version>
</dependency>
...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

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
}

创建转换器与方法

创建之前你肯定已经明确了需要转换的两个类，比如下面的代码示例，是将Car对象转换成一个CarDto对象

@Mapper //指定该类为mapstruct的映射器
public interface CarMapper {
     // 通过Class