MapStruct 中如何通过自定义方法实现多源字段联合计算映射

本文介绍在 mapstruct 中避免使用 `@aftermapping`，转而通过 `expression` 调用带完整上下文的自定义方法，实现基于多个源字段（如 `source.pac.temperature` 和 `source.range`）动态计算目标字段（如 `containerid`）的优雅映射方案。

在 MapStruct 中，当目标字段的值需依赖多个源属性的组合运算（例如 source.pac.temperature 与 source.range 共同参与计算），直接使用 @Mapping(source = "...") 无法满足需求。虽然 @AfterMapping 可行，但它将逻辑移出声明式映射体，削弱可读性与可测试性，也不利于复用和单元验证。

更推荐的方式是：在 Mapper 接口内定义 default 方法，接收整个源对象作为参数，封装计算逻辑；再通过 @Mapping#expression 直接调用该方法。这种方式保持映射配置集中、语义清晰，且方法可独立测试。

✅ 正确示例：

@Mapper
public interface SourceToTargetMapper {

    @Mapping(target = "temperature", source = "pac.temperature")
    @Mapping(target = "containerId", expression = "java(calculateContainerId(source))")
    TargetABC toDto(Source source);

    default String calculateContainerId(Source source) {
        // 完整访问 source 及其嵌套对象，无限制
        BigDecimal temperature = source.getPac().getTemperature();
        RangeCalculator range = source.getRange();
        return range != null ? range.calculate(temperature) : null;
    }
}

⚠️ 注意事项：

• expression = "java(...)" 中的代码会原样嵌入生成的实现类，因此必须确保语法合法、变量名准确（如 source 是方法参数名，不可写成 s 或其他）；
• 自定义方法必须是 default（接口默认方法）或 static（需配合 @Mapper(uses = ...) 引入），不能是抽象方法；
• 若计算逻辑复杂或需复用，建议将 calculateContainerId 提取为独立服务类，并通过 @Mapper(uses = ContainerIdCalculator.class) 注入，再在 expression 中调用 containerIdCalculator.compute(source)；
• qualifiedByName 不适用于接收多个参数的场景——它仅用于重载同名方法的类型/语义区分（如 String → LocalDate vs Long → LocalDate），无法突破单参数限制，因此不满足本例中“需同时访问 pac.temperature 和 range”的核心诉求。

总结：对于跨字段联合计算，expression + default method 是 MapStruct 官方推荐、简洁高效且类型安全的解决方案。它让映射逻辑既声明式又富有表现力，是替代 @AfterMapping 的首选实践。