本文介绍如何在共享单例 modelmapper 实例的前提下，为相同的源类（如 user）和目标类（如 userdto）配置多种映射行为——例如默认全字段映射，以及跳过特定字段（如 address）的精简映射。
本文介绍如何在共享单例 modelmapper 实例的前提下，为相同的源类（如 user）和目标类（如 userdto）配置多种映射行为——例如默认全字段映射，以及跳过特定字段（如 address）的精简映射。
在实际项目中，我们常需对同一组 DTO 与实体类进行不同粒度的转换：有时需完整映射（含关联对象），有时仅需基础字段（如用于列表页摘要）。由于 ModelMapper 默认采用单例模式全局复用，直接调用 modelMapper.map(...) 会始终执行同一映射规则。因此，不能依赖新建 ModelMapper 实例，而应通过「类型映射（TypeMap）」的多配置能力实现差异化映射。
✅ 正确做法：定义多个 TypeMap 并命名区分
ModelMapper 允许为同一
示例：配置“全量映射”与“地址跳过映射”
// 初始化单例 ModelMapper（通常在 Spring @Configuration 或工具类中）
ModelMapper modelMapper = new ModelMapper();
// 1. 默认映射（无需显式配置，ModelMapper 自动创建，等价于匿名 TypeMap）
// UserDto dto = modelMapper.map(user, UserDto.class);
// 2. 创建并配置名为 "withoutAddress" 的专用 TypeMap
modelMapper.createTypeMap(User.class, UserDto.class, "withoutAddress")
.addMappings(mapper -> mapper.skip(UserDto::setAddress));
使用方式：通过 TypeMap 名称触发对应策略
User user = new User("Alice", new Address("123 Main St"));
// ✅ 默认映射：包含 address
UserDto fullDto = modelMapper.map(user, UserDto.class);
// ✅ 指定 named TypeMap：跳过 address 字段
UserDto minimalDto = modelMapper.map(user, UserDto.class, "withoutAddress");
⚠️ 注意事项：
- createTypeMap(..., "name") 必须在首次映射前调用（如应用启动时初始化），重复调用同名 TypeMap 会抛出异常；
- skip() 接收的是目标类的 setter 方法引用（如 UserDto::setAddress），确保该方法存在且可访问；
- 若 Address 字段在 UserDto 中为 null 安全类型（如 Optional），跳过操作将保持其默认值（如 Optional.empty()）；
- 不建议在运行时动态创建 TypeMap（影响性能与线程安全），应统一在初始化阶段完成配置。
? 进阶：支持更复杂的条件跳过（如基于上下文）
若需根据运行时条件（如用户权限、API 版本）动态决定是否映射 address，可结合 Converter 实现：
modelMapper.createTypeMap(User.class, UserDto.class, "contextual")
.addMapping(
src -> shouldIncludeAddress() ? src.getAddress() : null,
(dest, value) -> {
if (value != null) dest.setAddress((Address) value);
}
);
但对大多数场景，“命名 TypeMap + skip()” 已足够清晰、高效且符合 ModelMapper 最佳实践。
综上，通过 createTypeMap(..., "name") 显式声明多套映射策略，并在 map() 调用中传入对应名称，即可在单例 ModelMapper 下优雅支持同一类对的多种映射逻辑，兼顾可维护性与性能。
