ModelMapper 支持通过 ConditionalConverter 实现全局、条件驱动的类型转换，无需为每个字段或每个 DTO 显式配置映射，即可自动将任意 Labelled 实例转为本地化字符串。
modelmapper 支持通过 `conditionalconverter` 实现全局、条件驱动的类型转换，无需为每个字段或每个 dto 显式配置映射，即可自动将任意 `labelled` 实例转为本地化字符串。
在实际项目中，当多个领域实体（如 Vegetable、Protein、Starch）共同实现某个标记/行为接口（如 Labelled），且需统一转换为其国际化消息文本（String）时，重复为每个 DTO 的每个对应字段调用 map().using(...) 不仅冗余，还严重违背开闭原则——新增字段即需修改配置。
ModelMapper 提供了更优雅的解决方案：隐式类型转换（Implicit Conversion），其核心是将自定义转换器注册到 Configuration.getConverters() 集合中，并让转换器自身决定是否参与某次转换——这正是 ConditionalConverter 的设计目的。
✅ 正确做法：使用 ConditionalConverter 注册全局规则
首先，将转换器改为实现 ConditionalConverter<labelled string></labelled> 接口，并精准控制匹配逻辑：
public class LabelledToStringConverter implements ConditionalConverter<Labelled, String> {
private final MessageSource messageSource;
public LabelledToStringConverter(MessageSource messageSource) {
this.messageSource = messageSource;
}
@Override
public MatchResult match(Class<?> sourceType, Class<?> destinationType) {
// 仅当源类型是 Labelled 或其子类，且目标类型为 String 时才触发
return Labelled.class.isAssignableFrom(sourceType)
&& String.class.isAssignableFrom(destinationType)
? MatchResult.FULL
: MatchResult.NONE;
}
@Override
public String convert(MappingContext<Labelled, String> context) {
Labelled source = context.getSource();
if (source == null) return null;
Locale locale = LocaleContextHolder.getLocale();
String messageCode = source.getLabel();
return messageSource.getMessage(messageCode, null, messageCode, locale);
}
}⚠️ 注意：
match()方法返回MatchResult.FULL表示完全匹配（优先级最高），MatchResult.PARTIAL可用于模糊匹配，MatchResult.NONE则跳过该转换器。
接着，在 ModelMapper 初始化时，将其注入全局转换器链：
@Configuration
public class ModelMapperConfig {
@Bean
public ModelMapper modelMapper(MessageSource messageSource) {
ModelMapper modelMapper = new ModelMapper();
// ✅ 关键：注册为 ConditionalConverter，启用隐式转换
modelMapper.getConfiguration()
.getConverters()
.add(new LabelledToStringConverter(messageSource));
// 其他显式映射（如字段名不一致、嵌套对象等）仍可保留
// modelMapper.createTypeMap(Dinner.class, DinnerDto.class)
// .addMapping(Dinner::getName, DinnerDto::setName);
return modelMapper;
}
}此时，只要 DinnerDto 中任意属性（如 veg、starch、protein）声明为 String 类型，而 Dinner 中对应 getter（如 getVegetable()）返回 Labelled 子类实例，ModelMapper 就会在映射过程中自动识别并应用该转换器，无需任何 .map().using(...) 手动绑定。
? 补充说明与最佳实践
-
优先级高于显式映射：
ConditionalConverter在隐式映射阶段生效，早于TypeMap中定义的显式规则；若已存在同类型TypeMap显式指定了 converter，则以显式为准。 -
线程安全：
ModelMapper实例应为单例（Spring 默认），ConditionalConverter实例也需无状态或仅含不可变依赖（如本例中的MessageSource是线程安全的）。 -
调试技巧：启用日志
logging.level.org.modelmapper=DEBUG可观察匹配过程与转换器调用链。 -
扩展性提示：类似模式适用于其他通用场景，例如
LocalDateTime ↔ String格式化、Enum ↔ String序列化、Optional<t> → T</t>解包等。
通过这一方式，你彻底解耦了转换逻辑与具体模型结构，真正实现了“一次配置、处处生效”的自动化映射能力。
