?

?

痛点

一种框架的出现都要解决个痛点，我想下面这这种不方便的操作经常有人写吧。

假如Car 类是数据库映射类

?

?

?

?

CarDTO是DTO 类

?

?

通常我们会这么写一个方法进行转换

?

?

甚至中间还牵涉了很多类型转换，嵌套之类的繁琐操作，而我们想要的只是建立它们之间的映射关系而已。有没有一种通用的映射工具来帮我们搞定这一切。当然有而且还不少。有人说apache的BeanUtil.copyProperties 可以实现，但是性能差而且容易出异常，很多规范严禁使用这种途径。以下是对几种对象映射框架的对比，大多数情况下 MapStruct 性能最高。类似于lombok ，Mapstruct都是在编译期进行实现，所以一般不存在运行时性能问题。

?

?

所以今天就搞一搞MapStruct, 无论是idea 还是eclipse 都建议安装 mapstruct 插件。

安装

引入maven 依赖坐标

?

?

编写映射

我们把开始的痛点解决一下，编写Car到CarDTO的映射。

?

?

声明一个映射接口用@org.mapstruct.Mapper 标记，说明这是一个bean转换接口。这里我们声明了一个 CAR_MAPPING 来方便我们调用，CarDTO toCarDTO(Car car)是不是很熟悉， 像mybatis一样抽象出我们的转换方法。org.mapstruct.Mapping注解用来声明成员属性的映射。这里以成员变量的参数名为依据，如果有嵌套比如Car里面有个CarType类型的成员变量type，其type属性 来映射CarDTO中的type字符串，我们使用type.type 来获取属性值。如果有多层以此类推。mapStruct 最终调用的是setter和getter 方法，而非反射。这也是其性能比较好的原因之一。numberOfSeats 映射到seatCount 就比较好理解了。我们是不是忘记了一个属性make，因为他们的位置且名称完全一致，所以可以省略。而且对于包装类是自动拆箱封箱操作的，并且是线程安全的。MapStruct不单单有这些功能，还有其他一些复杂的功能：

• 设置转换默认值和常量。当目标值是null 我们可以设置其默认值，注意这些都是基本类型以及对应都boxing类型，如下

 @Mapping(target = "stringProperty", source = "stringProp", defaultValue = "undefined")

需要注意的是常量不能对源进行引用（不能指定source属性），下面是正确的操作

 @Mapping(target = "stringConstant", constant = "Constant Value")

• 格式化也是我们经常使用的操作，比如数字格式化，日期格式化。

这是处理数字格式化的操作，遵循java.text.DecimalFormat的规范

 @Mapping(source = "price", numberFormat = "$#.00")

下面展示了将一个日期集合映射到日期字符串集合的格式化操作上，遵循的

 @IterableMapping(dateFormat = "dd.MM.yyyy")
 List<String> stringListToDateList(List<Date> dates);

• 我们还经常使用spring component 来处理 我们只需要这么声明，不用再构建一个单例，就可以像其他 spring bean一样对CarMapping 进行引用了。

?

?

总结

其实MapStruct 还有很多的功能。但是从可读性来说，我建议只使用以上几种容易理解的功能即可，过于复杂也不利于后期维护。如果你感兴趣可以去mapstruct.org进一步学习。配合lombok和我的jsr303教程，让你更加专注于业务，而且代码更加清晰。

我是码农小胖哥，关注我的头条或者公众号，天天有干货。有问题可以留言或者私信，觉得写的不错可以点个赞，转发一下。