mapstruct-plus/docs/guide/map-to-class.md

title, order, category, description

title	order	category	description
Map 转对象	2	指南	MapStructPlus Map转为对象 map convert to class

MapStructPlus 提供了更加强大的 Map<String, Object> 转对象的功能。

::: warning MapStructPlus 1.4.0 及以后版本，不再内置 Hutool 框架，如果需要用到该功能时，需要额外引入 hutool-core 依赖。 :::

使用

添加依赖

1.4.0 及以后的版本需要添加该依赖，1.4.0之前的版本内置 hutool，不需要额外添加。

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-core</artifactId>
    <version>${hutool.version}</version>
</dependency>

添加注解

当想要自动生成 Map<String, Object> 转为目标类的接口及实现类时，只需要在目标类上添加 @AutoMapMapper 注解。

支持的 value 类型

• String
• BigDecimal
• BigInteger
• Integer
• Long
• Double
• Boolean
• Date
• LocalDateTime
• LocalDate
• LocalTime
• URI
• URL
• Calendar
• Currency
• 自定义类（自定义类也需要增加 @AutoMapMapper 注解）

转换逻辑

针对目标类中的一个属性，首先会判断 Map 中是否存在该键，如果存在的话，首先判断类型，如果相同类型，直接强转，如果不同类型，则会基于 Hutool 提供的类型转换工具尝试转换为目标类型。

且同时支持内部嵌套 Map<String, Object> 属性转为内部嵌套的自定义类型属性。

示例

• 定义两个对象：MapModelA 和 MapModelB

:::: code-group ::: code-group-item MapModelA

@AutoMapMapper
@Data
public class MapModelA {

    private String str;
    private int i1;
    private Long l2;
    private MapModelB mapModelB;

}

::: ::: code-group-item MapModelB

@AutoMapMapper
@Data
public class MapModelB {

    private Date date;

}

::: ::::

• 转换测试

@SpringBootTest
public class QuickStartTest {

    @Autowired
    private Converter converter;

    @Test
    public void test() {
        Map<String, Object> mapModel1 = new HashMap<>();
        mapModel1.put("str", "1jkf1ijkj3f");
        mapModel1.put("i1", 111);
        mapModel1.put("l2", 11231);

        Map<String, Object> mapModel2 = new HashMap<>();
        mapModel2.put("date", DateUtil.parse("2023-02-23 01:03:23"));

        mapModel1.put("mapModelB", mapModel2);

        final MapModelA mapModelA = converter.convert(mapModel1, MapModelA.class);
        System.out.println(mapModelA);  // MapModelA(str=1jkf1ijkj3f, i1=111, l2=11231, mapModelB=MapModelB(date=2023-02-23 01:03:23))
    }
}