零配置，零麻烦：MapStruct 的轻松对象映射之旅
- 前言
- MapStruct是什么
- 快速上手：基础映射
- 高级映射技巧
- 1. 针对复杂类型的映射：
- 2. 自定义映射逻辑：
- MapStruct 的进阶用法
- 1. 构造函数映射：
- 2. 嵌套映射：
- 3. 集合映射：
- 伪出错
- 结语：
前言
你是否曾为繁琐的对象映射代码而感到头疼？MapStruct 登场了！它不仅是 Java 开发者的得力助手，更是一个能够消除样板代码的魔法师。在这篇博客中，我们将一同踏上 MapStruct 的奇妙之旅，解锁它的神奇技能，让你的代码更为简洁、高效。
MapStruct是什么
MapStruct 是一个用于 Java 编程语言的对象映射框架，它的主要目标是简化 Java bean 类型之间的映射过程。在软件开发中，经常需要将一个对象的数据映射到另一个对象，而 MapStruct 通过注解处理器的方式，根据开发者提供的映射规则自动生成映射代码，从而减少手动编写重复、繁琐的映射代码的工作。
MapStruct 的定位是提供一种高性能、可扩展、易用的对象映射解决方案。相比其他对象映射框架，MapStruct 有以下优势：
-
性能优越： 由于 MapStruct 生成的映射代码是静态的，在编译期间就已经生成，因此它的性能通常比运行时反射的映射框架更高效。
-
可读性和维护性： MapStruct 生成的映射代码相对清晰简洁，易于阅读和维护。生成的代码包含了开发者定义的映射规则，也支持自定义转换逻辑。
-
类型安全： MapStruct 在编译期间就能够检测到潜在的映射错误，提供了类型安全性，减少了在运行时可能发生的错误。
-
灵活性： 支持自定义转换器，开发者可以通过注解指定特定的映射规则，也可以手动编写转换器以满足特定需求。
总体而言，MapStruct 是一款强大的对象映射框架，适用于各种 Java 项目，尤其在需要处理大量对象映射的场景下，能够提高开发效率并保证映射代码的质量。
快速上手：基础映射
快速上手 MapStruct 的基础映射需要完成一些简单的步骤。以下是一个基本的示例，演示如何创建一个简单的映射。
假设有两个类 Source 和 Target，它们具有相似的字段，我们希望将一个对象映射到另一个对象。
-
引入 MapStruct 依赖：
在项目的
pom.xml文件中，添加 MapStruct 的依赖：<dependencies> <!-- 其他依赖 --> <dependency> <groupId>org.mapstruct</groupId> <artifactId>mapstruct</artifactId> <version>1.4.2.Final</version> <!-- 查看最新版本 --> </dependency> </dependencies> -
配置 Maven 插件：
在
pom.xml中，添加 MapStruct 的 Maven 插件配置：<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <!-- 适配你的 Java 版本 --> <target>1.8</target> <!-- 适配你的 Java 版本 --> </configuration> </plugin> <plugin> <groupId>org.mapstruct</groupId> <artifactId>mapstruct-maven-plugin</artifactId> <version>1.4.2.Final</version> <!-- 查看最新版本 --> <executions> <execution> <goals> <goal>compile</goal> </goals> <configuration> <sourceDirectory>src/main/java</sourceDirectory> <targetDirectory>target/generated-sources/mapstruct</targetDirectory> </configuration> </execution> </executions> </plugin> </plugins> </build> -
创建源和目标类：
// Source 类 public class Source { private String name; private int age; // Getters and setters }// Target 类 public class Target { private String name; private int age; // Getters and setters } -
创建映射接口：
import org.mapstruct.Mapper; import org.mapstruct.Mapping; @Mapper public interface SourceTargetMapper { @Mapping(source = "name", target = "name") @Mapping(source = "age", target = "age") Target sourceToTarget(Source source); }在上述代码中，
@Mapper注解表示这是一个 MapStruct 映射接口。@Mapping注解用于指定源对象和目标对象字段的映射关系。 -
生成映射代码：
在 Maven 项目中，运行以下 Maven 命令：
mvn clean install这将触发 MapStruct 的注解处理器生成映射代码。
以上就是一个简单的 MapStruct 映射示例。请注意，这只是一个入门级的例子，MapStruct 还支持更复杂的映射，包括集合映射、嵌套映射等。通过适当的注解和配置，你可以灵活地定义映射规则，以满足项目的需求。
高级映射技巧
在 MapStruct 中，你可以使用高级映射技巧来处理复杂类型的映射，并定义自定义映射逻辑。以下是一些示例：
1. 针对复杂类型的映射：
假设有一个包含复杂类型的类 Person，其中包含了 Address 类型的地址信息。我们希望将 Person 类型映射到 PersonDTO 类型。
// Person 类
public class Person {
private String name;
private Address address;
// Getters and setters
}
// Address 类
public class Address {
private String city;
private String street;
// Getters and setters
}
// PersonDTO 类
public class PersonDTO {
private String name;
private String city;
// Getters and setters
}
然后，创建映射接口并定义映射规则：
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
@Mapper
public interface PersonMapper {
@Mapping(source = "name", target = "name")
@Mapping(source = "address.city", target = "city")
PersonDTO personToPersonDTO(Person person);
}
在上述代码中，通过使用点号 . 来表示嵌套属性的映射关系，你可以轻松地处理复杂类型的映射。
2. 自定义映射逻辑：
有时候，你可能需要自定义映射逻辑以满足特定的需求。例如，如果需要将 Date 类型转换成字符串类型，可以使用自定义的转换器。
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.factory.Mappers;
import java.text.SimpleDateFormat;
@Mapper
public interface CustomMapper {
CustomMapper INSTANCE = Mappers.getMapper(CustomMapper.class);
@Mapping(source = "date", target = "formattedDate", qualifiedByName = "dateFormat")
Target customMapping(Source source);
String dateFormat(java.util.Date date);
class Target {
private String formattedDate;
// Getter and setter
}
class Source {
private java.util.Date date;
// Getter and setter
}
}
在上述例子中，通过在映射接口中定义名为 dateFormat 的方法，并在 @Mapping 注解中使用 qualifiedByName 属性，实现了对 Date 类型的自定义转换。
这些是一些高级映射技巧的简单示例。MapStruct 提供了丰富的注解和配置选项，可以满足各种映射需求。根据项目的具体情况，你可以进一步探索 MapStruct 的文档以了解更多高级用法。
MapStruct 的进阶用法
MapStruct 提供了一些进阶用法，包括构造函数映射、嵌套映射和集合映射。下面分别介绍这些进阶用法：
1. 构造函数映射：
在某些情况下，你可能希望使用构造函数进行映射。MapStruct 允许你在映射接口中使用构造函数映射，这样可以更加灵活地处理对象创建过程。
假设有一个类 Person，它有一个包含多个参数的构造函数，我们希望将其映射到 PersonDTO 类型。
// Person 类
public class Person {
private String name;
private int age;
// 构造函数
public Person(String name, int age) {
this.name = name;
this.age = age;
}
// Getters and setters
}
// PersonDTO 类
public class PersonDTO {
private String name;
private int age;
// 构造函数
public PersonDTO(String name, int age) {
this.name = name;
this.age = age;
}
// Getters and setters
}
然后，在映射接口中使用构造函数映射：
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
@Mapper
public interface PersonMapper {
@Mapping(target = "name", source = "name")
@Mapping(target = "age", source = "age")
PersonDTO personToPersonDTO(Person person);
}
MapStruct 会自动识别构造函数映射的关系，并生成相应的映射代码。
2. 嵌套映射：
MapStruct 支持嵌套映射，允许你在对象之间建立更复杂的映射关系。假设有一个嵌套的类结构，如 Order 包含 Customer，我们希望将 Order 映射到 OrderDTO，同时也映射 Customer 到 CustomerDTO。
// Order 类
public class Order {
private String orderId;
private Customer customer;
// Getters and setters
}
// Customer 类
public class Customer {
private String name;
private String address;
// Getters and setters
}
// OrderDTO 类
public class OrderDTO {
private String orderId;
private CustomerDTO customer;
// Getters and setters
}
// CustomerDTO 类
public class CustomerDTO {
private String name;
private String address;
// Getters and setters
}
在映射接口中进行嵌套映射：
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
@Mapper
public interface OrderMapper {
@Mapping(source = "customer", target = "customer")
OrderDTO orderToOrderDTO(Order order);
@Mapping(source = "name", target = "name")
@Mapping(source = "address", target = "address")
CustomerDTO customerToCustomerDTO(Customer customer);
}
MapStruct 会根据映射接口中的定义自动生成嵌套映射代码。
3. 集合映射：
MapStruct 也支持集合的映射。假设有一个类 Library 包含了多个书籍 Book，我们希望将 Library 映射到 LibraryDTO，同时也映射其中的书籍列表。
// Book 类
public class Book {
private String title;
private String author;
// Getters and setters
}
// Library 类
public class Library {
private List<Book> books;
// Getters and setters
}
// LibraryDTO 类
public class LibraryDTO {
private List<BookDTO> books;
// Getters and setters
}
// BookDTO 类
public class BookDTO {
private String title;
private String author;
// Getters and setters
}
在映射接口中进行集合映射：
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
@Mapper
public interface LibraryMapper {
@Mapping(source = "books", target = "books")
LibraryDTO libraryToLibraryDTO(Library library);
@Mapping(source = "title", target = "title")
@Mapping(source = "author", target = "author")
BookDTO bookToBookDTO(Book book);
}
MapStruct 会根据映射接口中的定义自动生成集合映射代码。
这些是 MapStruct 的一些进阶用法，它们能够帮助你更灵活地处理复杂的映射场景。根据项目需求，你可以结合这些技巧，定制符合你业务逻辑的映射规则。
伪出错
1、报错 java.lang.ClassNotFoundException: Cannot find implementation for fun.todoitbo.botally.convert.TbBillConvert
这里要观察你的@Mapper注解，你可能错把mybatis中的@Mapper当成宝了
2、映射返回的结果都是null
出现上面的情况，要观察，是否存在目标类上没有set，get方法
3、我修改了源类或者目标类但是他没有生效
这里你需要clear一下，重新启动，因为它的实现方法只生成一次
结语：
通过本文的深度探索，相信你将对 MapStruct 有了全新的认识，并能够在你的项目中充分发挥它的威力。让我们一同掌握这门“魔法”，让代码变得更加清爽、优雅！
