对象转换工具

开始之前

po：跟表明相同

Mapstruct

优点

1. 通过使用普通方法调用（settter/getter）而不是反射来快速执行
2. 编译时类型安全性：只能映射相互映射的对象和属性，不能将order实体意外映射到customer DTO等。
3. 如果有如下问题，编译时会抛出异常
   3.1 映射不完整（并非所有目标属性都被映射）
   3.2 映射不正确（找不到正确的映射方法或类型转换）

Maven

<!--mapStruct依赖 高性能对象映射-->
            <!--mapstruct核心-->
            <dependency>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct</artifactId>
                <version>1.5.0.Beta1</version>
            </dependency>
            <!--mapstruct编译-->
            <dependency>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct-processor</artifactId>
                <version>1.5.0.Beta1</version>
            </dependency>

定义一个映射器

2.1基本映射

要创建映射器，只需使用所需的映射方法定义一个Java接口，并用注释对其进行org.mapstruct.Mapper注释：
该@Mapper注释将使得MapStruct代码生成器创建的执行PersonMapper 过程中生成时的界面。

在生成的方法实现中，源类型（例如Person）的所有可读属性都将被复制到目标类型（例如PersonDTO）的相应属性中：

1. 当一个属性与其目标实体对应的名称相同时，它将被隐式映射。
2. 当属性在目标实体中具有不同的名称时，可以通过@Mapping注释指定其名称。

==如果不指定@Mapping，默认映射name相同的field==
==如果映射的对象field name不一样，通过 @Mapping 指定。==
==忽略字段加@Mapping#ignore() = true==

2.2 指定默认值

@Mapping(target = “describe”, source = “describe”, defaultValue = “默认值”)

2.3 使用表达式

@Mapping(target = “createTime”,expression = “java(new java.util.Date())”)

2.4 dateFormat()

如果属性从字符串映射到日期，则该格式字符串可由SimpleDateFormat处理，反之亦然。当映射枚举常量时，将忽略所有其他属性类型。

2.5 逆映射

在双向映射的情况下，例如从实体到DTO以及从DTO到实体，前向方法和反向方法的映射规则通常是相似的，并且可以通过切换source和来简单地反转target。

使用注释@InheritInverseConfiguration表示方法应继承相应反向方法的反向配置

@Mapping(target = "age",source = "age", numberFormat = "#0.00")
PersonDTO conver(Person person);

@InheritInverseConfiguration
Person conver(PersonDTO dto);

2.6 集成到 spring

@Mapper(componentModel = “spring”)

2.7实例

@Mapper(componentModel = "spring")
//交给spring容器管理就不用下面的获取Mapper对象了
//它可以使Spring自动扫描和注册Mapper接口的实现类，并将其作为Spring组件进行管理。
// 这样可以直接使用依赖注入的方式来获取Mapper实例，而无需手动创建和配置Mapper对象。
public interface BoyGirlConverter {

//Mappers.getMapper 方法用于获取指定类型的 Mapper 对象。MapStruct 是一个代码生成器，它可以根据接口定义自动生成实现数据转换的 Mapper 类。
// 通过调用 Mappers.getMapper 方法，可以获取到已经生成的 Mapper 实例，以便在代码中使用该实例进行数据转换操作。
// BoyGirlConverter INSTANCE = Mappers.getMapper(BoyGirlConverter.class);

    @Mappings(
            //忽视该属性
            @Mapping(target = "girlFriends",ignore = true)
    )
    CoolBoyDto po2Dto(CoolBoy coolBoy);

    //expression是写java语句
    @Mappings(
            @Mapping(target = "girlType",expression = "java(girlType(coolGirl.getGirlType()))")
    )
    CoolGirlDto po2Dto(CoolGirl coolGirl);

    //自动通过po2Dto会推断
    List<CoolBoy> po2DtoBoys(List<CoolBoy> coolBoyList);

    @Mapping(source = "salary",target = "salary")
    CoolBoyVo boyDto2Vo(CoolBoyDto coolBoyDto);

    /**
     * 反转
     * @param CoolBoyVo
     * @return
     */
    @InheritConfiguration(name = "boyDto2Vo")
    CoolBoyDto vo2Dto(CoolBoyDto CoolBoyVo);

    default String girlType(Integer girlTypeCode){
        return GirlTypeEnums.byCode(girlTypeCode).getLabel();
    }
}

写这样一个mapper就可以进行对象自动转换。