MapStruct 教程

MapStruct 是一个注解处理器，它被插入到 Java 编译器中。 一旦插入，它就可以被命令行工具如maven、gradle使用来处理映射注解，从而在编译时创建一个映射器类。

什么时候需要映射？

在多层应用程序中，数据对象用于从数据库中获取数据，并且 UI 与模型交互。 现在需要将获取到数据模型中的数据映射到模型或 java bean 以传递给 UI。考虑以下情况。

与数据库连接的实体类。

StudentEntity.java

@Entity
class StudentEntity {
   String id;
   String name;
}

与 UI 连接的模型类。

Student.java

class Student {
   String id;
   String name;
}

MapStruct 是如何工作的？

MapStruct 使用注解自动创建映射器以将数据对象与模型对象映射的过程。 它在编译时创建了一个映射器实现，帮助开发人员在开发过程中找出错误并使易于理解。 例如

StudentMapper.java

@Mapper
class StudentMapper {
   StudentMapper INSTANCE = Mappers.getMapper( StudentMapper.class );   
   StudentEntity modelToEntity(Student student);
}

现在 StudentMapper.INSTANCE 可用于轻松获取映射对象。

StudentEntity studentEntity = StudentMapper.INSTANCE.modelToEntity(student);

阅读前需要准备的知识

本教程是为希望以简单易懂的方式学习 MapStruct 及其概念的基础知识的软件程序员而设计的。 本教程将通过适当的示例让大家充分了解 mapstruct 的各种功能。在继续本教程之前，大家应该对 Java 编程语言 有基本的了解。