丢弃掉那些BeanUtils工具类吧，MapStruct真香！！！

这是Hollis的第 298 篇原创分享

作者 l Hollis

来源 l Hollis（ID：hollischuang）

在前几天的文章《为什么阿里巴巴禁止使用Apache Beanutils进行属性的copy？》中，我曾经对几款属性拷贝的工具类进行了对比。

然后在评论区有些读者反馈说MapStruct才是真的香，于是我就抽时间了解了一下MapStruct。结果我发现，这真的是一个神仙框架，炒鸡香。

这一篇文章就来简单介绍下MapStruct的用法，并且再和其他几个工具类进行一下对比。

首先，我们先说一下MapStruct这类框架适用于什么样的场景，为什么市面上会有这么多的类似的框架。

在软件体系架构设计中，分层式结构是最常见，也是最重要的一种结构。很多人都对三层架构、四层架构等并不陌生。

甚至有人说："计算机科学领域的任何问题都可以通过增加一个间接的中间层来解决，如果不行，那就加两层。"

但是，随着软件架构分层越来越多，那么各个层次之间的数据模型就要面临着相互转换的问题，典型的就是我们可以在代码中见到各种O，如DO、DTO、VO等。

一般情况下，同样一个数据模型，我们在不同的层次要使用不同的数据模型。如在数据存储层，我们使用DO来抽象一个业务实体；在业务逻辑层，我们使用DTO来表示数据传输对象；到了展示层，我们又把对象封装成VO来与前端进行交互。

那么，数据的从前端透传到数据持久化层（从持久层透传到前端），就需要进行对象之间的互相转化，即在不同的对象模型之间进行映射。

通常我们可以使用get/set等方式逐一进行字段映射操作，如：

 
 personDTO.setName(personDO.getName());

personDTO.setAge(personDO.getAge());

personDTO.setSex(personDO.getSex());

personDTO.setBirthday(personDO.getBirthday()); 

但是，编写这样的映射代码是一项冗长且容易出错的任务。MapStruct等类似的框架的目标是通过自动化的方式尽可能多地简化这项工作。

MapStruct（https://mapstruct.org/ ）是一种代码生成器，它极大地简化了基于"约定优于配置"方法的Java bean类型之间映射的实现。生成的映射代码使用纯方法调用，因此快速、类型安全且易于理解。

约定优于配置，也称作按约定编程，是一种软 件设计范式，旨在减少软件开发人员需做决定的数量，获得简单的好处，而又不失灵活性。

假设我们有两个类需要进行互相转换，分别是PersonDO和PersonDTO，类定义如下：

 
 public class PersonDO {

    private Integer id;

    private String name;

    private int age;

    private Date birthday;

    private String gender;

}



public class PersonDTO {

    private String userName;

    private Integer age;

    private Date birthday;

    private Gender gender;

} 

我们演示下如何使用MapStruct进行bean映射。

想要使用MapStruct，首先需要依赖他的相关的jar包，使用maven依赖方式如下：

 
 ...

<properties>

    <org.mapstruct.version>1.3.1.Final</org.mapstruct.version>

</properties>

...

<dependencies>

    <dependency>

        <groupId>org.mapstruct</groupId>

        <artifactId>mapstruct</artifactId>

        <version>${org.mapstruct.version}</version>

    </dependency>

</dependencies>

...

<build>

    <plugins>

        <plugin>

            <groupId>org.apache.maven.plugins</groupId>

            <artifactId>maven-compiler-plugin</artifactId>

            <version>3.8.1</version>

            <configuration>

                <source>1.8</source> <!-- depending on your project -->

                <target>1.8</target> <!-- depending on your project -->

                <annotationProcessorPaths>

                    <path>

                        <groupId>org.mapstruct</groupId>

                        <artifactId>mapstruct-processor</artifactId>

                        <version>${org.mapstruct.version}</version>

                    </path>

                    <!-- other annotation processors -->

                </annotationProcessorPaths>

            </configuration>

        </plugin>

    </plugins>

</build> 

因为MapStruct需要在编译器生成转换代码，所以需要在maven-compiler-plugin插件中配置上对mapstruct-processor的引用。这部分在后文会再次介绍。

之后，我们需要定义一个做映射的接口，主要代码如下：

 
 @Mapper

interface PersonConverter {

    PersonConverter INSTANCE = Mappers.getMapper(PersonConverter.class);

    @Mappings(@Mapping(source = "name", target = "userName"))

    PersonDTO do2dto(PersonDO person);

} 

使用注解@Mapper定义一个Converter接口，在其中定义一个do2dto方法，方法的入参类型是PersonDO，出参类型是PersonDTO，这个方法就用于将PersonDO转成PersonDTO。

测试代码如下：

 
 public static void main(String[] args) {

    PersonDO personDO = new PersonDO();

    personDO.setName("Hollis");

    personDO.setAge(26);

    personDO.setBirthday(new Date());

    personDO.setId(1);

    personDO.setGender(Gender.MALE.name());

    PersonDTO personDTO = PersonConverter.INSTANCE.do2dto(personDO);

    System.out.println(personDTO);

} 

输出结果：

 
 PersonDTO{userName='Hollis', age=26, birthday=Sat Aug 08 19:00:44 CST 2020, gender=MALE} 

可以看到，我们使用MapStruct完美的将PersonDO转成了PersonDTO。

上面的代码可以看出，MapStruct的用法比较简单，主要依赖@Mapper注解。

但是我们知道，大多数情况下，我们需要互相转换的两个类之间的属性名称、类型等并不完全一致，还有些情况我们并不想直接做映射，那么该如何处理呢？

其实MapStruct在这方面也是做的很好的。

首先，可以明确的告诉大家，如果要转换的两个类中源对象属性与目标对象属性的类型和名字一致的时候，会自动映射对应属性。

那么，如果遇到特殊情况如何处理呢？

名字不一致如何映射

如上面的例子中，在PersonDO中用name表示用户名称，而在PersonDTO中使用userName表示用户名，那么如何进行参数映射呢。

这时候就要使用@Mapping注解了，只需要在方法签名上，使用该注解，并指明需要转换的源对象的名字和目标对象的名字就可以了，如将name的值映射给userName，可以使用如下方式：

 
 @Mapping(source = "name", target = "userName") 

可以自动映射的类型

除了名字不一致以外，还有一种特殊情况，那就是类型不一致，如上面的例子中，在PersonDO中用String类型表示用户性别，而在PersonDTO中使用一个Genter的枚举表示用户性别。

这时候类型不一致，就需要涉及到互相转换的问题

其实，MapStruct会对部分类型自动做映射，不需要我们做额外配置，如例子中我们将String类型自动转成了枚举类型。

一般情况下，对于以下情况可以做自动类型转换：

• 基本类型及其他们对应的包装类型。
• 基本类型的包装类型和String类型之间
• String类型和枚举类型之间

自定义常量

@Mapping(source = "name", constant = "hollis")

类型不一致的如何映射

public class PersonDO {

    private String name;

    private String address;

}



public class PersonDTO {

    private String userName;

    private HomeAddress address;

}

@Mapper

interface PersonConverter {

    PersonConverter INSTANCE = Mappers.getMapper(PersonConverter.class);



    @Mapping(source = "userName", target = "name")

    @Mapping(target = "address",expression = "java(homeAddressToString(dto2do.getAddress()))")

    PersonDO dto2do(PersonDTO dto2do);



    default String homeAddressToString(HomeAddress address){

        return JSON.toJSONString(address);

    }

}

default方法： Java 8 引入的新的语言特性，用关键字default来标注，被default所标注的方法，需要提供实现，而子类可以选择实现或者不实现该方法

@Mapping(target = "address",expression = "java(homeAddressToString(dto2do.getAddress()))")

@Mapping(target = "birthday",dateFormat = "yyyy-MM-dd HH:mm:ss")

@Mapper

interface PersonConverter {

    PersonConverter INSTANCE = Mappers.getMapper(PersonConverter.class);



    @Mapping(source = "userName", target = "name")

    @Mapping(target = "address",expression = "java(homeAddressToString(dto2do.getAddress()))")

    @Mapping(target = "birthday",dateFormat = "yyyy-MM-dd HH:mm:ss")

    PersonDO dto2do(PersonDTO dto2do);



    default String homeAddressToString(HomeAddress address){

        return JSON.toJSONString(address);

    }

}

@Generated(

    value = "org.mapstruct.ap.MappingProcessor",

    date = "2020-08-09T12:58:41+0800",

    comments = "version: 1.3.1.Final, compiler: javac, environment: Java 1.8.0_181 (Oracle Corporation)"

)

class PersonConverterImpl implements PersonConverter {

    @Override

    public PersonDO dto2do(PersonDTO dto2do) {

        if ( dto2do == null ) {

            return null;

        }

        PersonDO personDO = new PersonDO();

        personDO.setName( dto2do.getUserName() );

        if ( dto2do.getAge() != null ) {

            personDO.setAge( dto2do.getAge() );

        }

        if ( dto2do.getGender() != null ) {

            personDO.setGender( dto2do.getGender().name() );

        }

        personDO.setAddress( homeAddressToString(dto2do.getAddress()) );

        return personDO;

    }

}

强烈推荐，真的很香！！！

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
往期推荐
 
 
 
 
 
 
 
 
 
 
 

用了Dapper之后通篇还是SqlConnection，真的看不下去了

实用！一键生成数据库文档，堪称数据库界的Swagger

为什么阿里巴巴要求日期格式化时必须有使用y表示年，而不能用Y？

 

直面Java第329期：哪个命令可以监控虚拟机各种运行状态信息？

深入并发第013期：拓展synchronized——锁优化

如果你喜欢本文,

请长按二维码，关注 Hollis.

转发至朋友圈，是对我最大的支持。