一: 前言

最近项目上打算使用MapStruct框架来做JavaBean的映射，所以对MapStruct框架做了一个整体的探究，希望大家看完后能够对MapStruct框架有个整体上的了解。

二: 基本介绍

为了文章的严谨，我想借助于官网的介绍再合适不过了:

是什么? MapStruct 是一个代码生成器，它基于约定而非配置方法，极大地简化了 Java Bean 类型之间映射的实现。生成的映射代码使用普通方法调用，因此快速、类型安全且易于理解。
为什么? 多层应用程序通常需要在不同的对象模型（例如实体和 DTO）之间进行映射。编写这样的映射代码是一项繁琐且容易出错的任务。MapStruct 旨在通过尽可能自动化来简化这项工作。与其他映射框架相比，MapStruct 在编译时生成 Bean 映射，这确保了高性能，允许快速的开发人员反馈和彻底的错误检查。
怎么做的? MapStruct 是一个注释处理器，它插入到 Java 编译器中，可以在命令行构建（Maven、Gradle 等）中使用，也可以在您喜欢的 IDE 中使用。

三: 技术点掌握

Java编译过程

我们都知道java编译将 ".java" 文件转换为 ".class" 字节码文件,最终 ".class" 字节码文件运行在jvm虚拟机之上，那java编译的过程是怎样的呢?下面简单用一张图来表示:

JSR269

用红色背景填充的"注解处理 "步骤就是我们要来说的JSR269规范:

在JDK1.5之后，Java语言提供了对注解（Annotation）的支持，这些注解与普通的Java代码一样，是在运行期间发挥作用的。在JDK1.6中实现了JSR-269规范，JSR-269：Pluggable Annotations Processing API（插入式注解处理API）。提供了一组插入式注解处理器的标准API在编译期间对注解进行处理。我们可以把它看做是一组编译器的插件，在这些插件里面，可以读取、修改、添加抽象语法树中的任意元素。如果这些插件在处理注解期间对语法树进行了修改，编译器将回到解析及填充符号表的过程重新处理，直到所有插入式注解处理器都没有再对语法树进行修改为止，每一次循环称为一个Round，这是一个回环过程。
并且在此阶段，如果项目中有注解处理器想生成新的源文件。可使用JavacFiler创建新的源文件，这些源文件在此时被加入到编译过程中。它们被视为项目源代码的一部分，并将在接下来的步骤中一起被编译。

使用Freemarker模板文件快速生成java类文件

Freemarker是一款模板引擎:即一种基于模板和要改变的数据，用来输出文本(HTML网页、电子邮件)，2002年编写者Attila在freemarker.ext*包里面支持了完成对javabean、jython、XML的映射。因此我们可以借助于这项模板引擎技术快速生成我们的java类。

实战

在这里我给大家找了两个可以快速入手上面技术点的实战例子，有兴趣的可以动起手来实操一个简单的demo体验下这些知识点:

JSR269实践

使用freemaker生成javabean

解析MapStruct实现

MapStcurt是在编译过程中生成类，我们这里是使用的是Maven包管理工具，Maven专门有命令(MvnDebug)提供给我们做编译时候的调试,然后我们可以通过idea配置远程调试看MapStruct的处理过程了。

准备调试环境

笔者这里演示使用的JDK是11版本,MapStruct是1.5.3.Final版本

运行MvnDebug命令

找到MapStruct注解处理类，在process方法上面打上断点

org.mapstruct.ap.MappingProcessor#process(java.util.Set<? extends javax.lang.model.element.TypeElement>, javax.annotation.processing.RoundEnvironment)：