业务代码的救星——Java 对象转换框架 MapStruct 妙用

里奥ii

大蒙古共和国海军十七师师长

在业务项目的开发中，我们经常需要将 Java 对象进行转换，比如从将外部微服务得到的对象转换为本域的业务对象 domainobject ，将 domainobject 转为数据持久层的 dataobject ，将 domainobject 转换为 DTO 以便返回给外部调用方等。在转换时大部分属性都是相同的，只有少部分的不同，如果手工编写转换代码，会很繁琐。这时我们可以通过一些对象转换框架来更方便的做这件事情。

这样的对象转换框架有不少，比较有名的有 ModelMapper 和 MapStruct。它们所使用的实现技术不同，ModelMapper 是基于反射的，通过反射来查找实体对象的字段，并读取或写入值，这样的方式实现原理简单，但性能很差。与 ModelMapper 框架不同的是，MapStruct 是基于编译阶段代码生成的，生成的转换代码在运行的时候跟一般的代码一样，没有额外的性能损失。本文重点介绍 MapStruct。

业务场景

假设现在有这么个场景，从数据库查询出来了一个 user 对象（包含 id，用户名，密码，手机号，邮箱，角色这些字段）和一个对应的角色对象 role（包含 id，角色名，角色描述这些字段），现在在 controller 需要用到 user 对象的 id，用户名，和角色对象的角色名三个属性。一种方式是直接把两个对象传递到 controller 层，但是这样会多出很多没用的属性。更通用的方式是需要用到的属性封装成一个类(DTO)，通过传输这个类的实例来完成数据传输。

实现方式之使用传统方式

如下：

User.java
@AllArgsConstructor
@Data
public class User {
 private Long id;
 private String username;
 private String password;
 private String phoneNum;
 private String email;
 private Role role;
}

Role.java
@AllArgsConstructor
@Data
public class Role {
 private Long id;
 private String roleName;
 private String description;
}

UserRoleDto.java

@Data
public class UserRoleDto {
     * 用户id
 private Long userId;
     * 用户名
 private String name;
     * 角色名
 private String roleName;
}

MainTest.java
测试类，模拟将 user 对象转换成 UserRoleDto 对象

public class MainTest {
 User user = null;
     * 模拟从数据库中查出 user 对象
 @Before
 public void before() {
 Role role  = new Role(2L, "administrator", "超级管理员");
        user  = new User(1L, "zhangsan", "12345", "17677778888", "123@qq.com", role);
     * 模拟把 user 对象转换成 UserRoleDto 对象
 @Test
 public void test1() {
 UserRoleDto userRoleDto = new UserRoleDto();
        userRoleDto.setUserId(user.getId());
        userRoleDto.setName(user.getUsername());
        userRoleDto.setRoleName(user.getRole().getRoleName());
 System.out.println(userRoleDto);
}

运行结果

上边的代码或许暂时看起来还是比较简洁的，但是我们需要注意的一点就是平时业务开发中的对象属性远不是上述代码中简简单单的几个字段，有可能会有数十个字段，同理也会数十个对象需要转换，我们如果还是通过 getter、setter 的方式把一个对象属性值复制到另一个对象中去还是非常麻烦的，不过不用担心，今天要介绍给大家的 MapStruct 就是用于解决这种问题的。

实现方式之使用 MapStruct

这里我们沿用上述代码中的基本对象 User.java 、 Role.java 、 UserRoleDto.java 。然后新建一个 UserRoleMapper.java ，这个来用来定义 User.java 、 Role.java 和 UserRoleDto.java 之间属性对应规则。

在这之前我们需要引入 MapStruct 的 pom 引用：

 <dependency>
 <groupId>org.mapstruct</groupId>
 <artifactId>mapstruct-jdk8</artifactId>
 <version>1.3.0.Final</version>
</dependency>

UserRoleMapper.java

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.Mappings;
import org.mapstruct.factory.Mappers;
 * @Mapper 定义这是一个MapStruct对象属性转换接口，在这个类里面规定转换规则
 *         在项目构建时，会自动生成改接口的实现类，这个实现类将实现对象属性值复制
@Mapper
public interface UserRoleMapper {
     * 获取该类自动生成的实现类的实例
     * 接口中的属性都是 public static final 的
     * 方法都是public abstract 的
 UserRoleMapper INSTANCES = Mappers.getMapper(UserRoleMapper.class);
     * 这个方法就是用于实现对象属性复制的方法
     * @Mapping 用来定义属性复制规则
     *              source 指定源对象属性
     *              target 指定目标对象属性
     * @param user 这个参数就是源对象，也就是需要被复制的对象
     * @return 返回的是目标对象，就是最终的结果对象
 @Mappings({
 @Mapping(source = "id", target = "userId"),
 @Mapping(source = "username", target = "name"),
 @Mapping(source = "role.roleName", target = "roleName")
 UserRoleDto toUserRoleDto(User user);
}

测试一下结果

MainTest.java

/**
     * 模拟通过MapStruct把user对象转换成UserRoleDto对象
 @Test
 public void test2() {
 UserRoleDto userRoleDto = UserRoleMapper.INSTANCES.toUserRoleDto(user);
 System.out.println(userRoleDto);
 }

呃，很明显，运行竟然报错了，具体异常如下：

核心是这一句： java.lang.ClassNotFoundException:Cannotfind implementationfortop.zhoudl.mapstruct.UserRoleMapper ,也就是说没有找到 UserRoleMapper 类的实现类。

通过查阅一些资料可得：

MapStruct 是一个可以处理注解的Java编译器插件，可以在命令行中使用，也可以在 IDE 中使用。MapStruc t有一些默认配置，但是也为用户提供了自己进行配置的途径。缺点就是这玩意在使用工具自带的编译器时不会生成实现类，需要通过 maven 的方式来进行编译，然后才会生成实现类。

所以我们需要增加一个编译插件到 pom 文件中：

<!-- 引入 processor -->
<dependency>
 <groupId>org.mapstruct</groupId>
 <artifactId>mapstruct-processor</artifactId>
 <version>1.3.0.Final</version>
 <scope>provided</scope>
</dependency>
<!--为 Maven compile plugin 设置 annotation processor -->
<plugins>
 <plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-compiler-plugin</artifactId>
 <version>3.5.1</version>
 <configuration>
 <source>1.8</source>
 <target>1.8</target>
 <annotationProcessorPaths>
 <groupId>org.mapstruct</groupId>
 <artifactId>mapstruct-processor</artifactId>