MapStruct工具类的使用

1.简介

MapStruct是一个代码生成器，它基于约定优于配置的原则，通过注解的方式，将Java bean对象之间进行属性拷贝。它避免了手动编写繁琐的getter/setter调用代码，大大提高了开发效率，并且生成的代码类型安全、性能高效。

2.作用

2.1 属性拷贝

MapStruct主要用于Java bean之间的属性拷贝。例如，您有一个用户信息的DTO（数据传输对象）和一个用户信息的实体类，这两个类之间有很多相同的属性。使用MapStruct，您可以定义一个Mapper接口，并通过注解指定源对象和目标对象，MapStruct会自动生成实现这个Mapper接口的代码，完成属性拷贝的工作。

2.2 类型安全

由于MapStruct是基于注解和代码生成的，它可以在编译时期就检查类型安全。如果源对象和目标对象的属性类型不匹配，编译将会失败，这有助于及早发现问题。

2.3 性能高效

MapStruct生成的代码是直接调用getter和setter方法，而不是使用反射，因此性能非常高效。这使得它非常适合在高并发、高性能要求的场景中使用。

2.4 自定义转换

MapStruct还支持自定义转换逻辑。如果您需要对某个属性的拷贝进行特殊处理，比如日期格式的转换，您可以通过实现自定义的转换方法，并在Mapper接口中指定使用这个方法进行转换。

3.如何使用

3.1 创建一个maven工程项目并引入mapstruct的坐标依赖：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.2.Final</version> <!-- 请使用最新版本 -->
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.2.Final</version> <!-- 请使用最新版本 -->
    <scope>provided</scope>
</dependency>

3.2 源对象类

/**
 * @ClassName JyFullOnlineTimeDO
 * @Description TODO
 * @Author xiaoxiao
 * @Date 2025/1/24
 */
public class JyFullOnlineTimeDO {
   
   

    private String reservedFieldOne;
    private String reservedFieldTwo;
    private String reservedFieldThree;

    // create getter and setter methods
    public String getReservedFieldOne() {
   
   
        return reservedFieldOne;
    }

    public void setReservedFieldOne(String reservedFieldOne) {
   
   
        this.reservedFieldOne = reservedFieldOne;
    }

    public String getReservedFieldTwo() {
   
   
        return reservedFieldTwo;
    }

    public void setReservedFieldTwo(String reservedFieldTwo) {
   
   
        this.reservedFieldTwo = reservedFieldTwo;
    }

    public String getReservedFieldThree() {
   
   
        return reservedFieldThree;
    }

    public void setReservedFieldThree(String reservedFieldThree) {
   
   
        this.reservedFieldThree = reservedFieldThree;
    }

}

3.3 目标对象类（和源对象类中的字段属性名相同）

/**
 * @ClassName CompanyOnlineSyncVO
 * @Description TODO
 * @Author xiaoxiao
 * @Date 2025/1/24
 */
public class CompanyOnlineSyncVO {
   
   

    private String reservedFieldOne;
    private String reservedFieldTwo;
    private String reservedFieldThree;
    //生成以上字段的getter和setter方法
    public String getReservedFieldOne