MapStruct 实现 A→B→C 链式映射方法

MapStruct 本身不支持自动链式调用（如 A → B → C），但可通过手动组合已有 Mapper 实例，在自定义方法中复用 toB() 和 toC(B)，实现简洁、可维护的 A → C 映射，并保留 @AfterMapping 等生命周期钩子能力。

MapStruct 本身不支持自动链式调用（如 A → B → C），但可通过手动组合已有 Mapper 实例，在自定义方法中复用 `toB()` 和 `toC(B)`，实现简洁、可维护的 A → C 映射，并保留 `@AfterMapping` 等生命周期钩子能力。

在 MapStruct 中，抽象 Mapper 类之间无法直接“继承”或“委托”映射逻辑，框架也不会自动将 A → B 和 B → C 组合成 A → C。但你完全可以通过显式依赖已有 Mapper 实例的方式，安全、清晰地复用已定义的映射逻辑——这正是官方推荐的“组合优于继承”实践。

✅ 推荐做法：分层 Mapper + 手动组合

将映射职责拆分为专注单一转换的 Mapper，并通过 Mappers.getMapper() 获取其实例，在更高层完成链式组装：

// A → B 映射器（专注转换逻辑与后处理）
@Mapper
public abstract class BMapper {
    public static final BMapper INSTANCE = Mappers.getMapper(BMapper.class);

    public abstract B toB(A a);

    @AfterMapping
    protected void additionalStuff(A a, @MappingTarget B b) {
        b.setProcessed(true);
        b.setSourceId(a.getId());
    }
}

// B → C 映射器（同样保持专注）
@Mapper
public abstract class CMapper {
    public static final CMapper INSTANCE = Mappers.getmapper(CMapper.class);

    public abstract C toC(B b);

    // 自定义 A → C：复用 BMapper + 增强逻辑
    public C toC(A a) {
        B b = BMapper.INSTANCE.toB(a);  // 复用已有复杂映射
        C c = toC(b);                    // 复用 B→C 标准映射
        additionalStuff(a, c);           // 补充 A→C 特有逻辑
        return c;
    }

    private void additionalStuff(A a, C c) {
        c.setDerivedName("A_" + a.getName() + "_via_B");
        c.setTimestamp(Instant.now());
    }
}

? 关键点说明：

• Mappers.getMapper() 是线程安全的，适用于单例模式调用；
• @AfterMapping 在 toC(B) 内部仍会生效（作用于 B→C 阶段），而 additionalStuff(A, C) 是你为 A→C 新增的专属后置逻辑；
• 所有类型安全、Null 安全、嵌套映射等 MapStruct 特性在各层均完整保留。

⚠️ 注意事项

• ❌ 不要在一个 @Mapper 类中同时声明 toB(A)、toC(B) 和 toC(A) 并期望框架自动串联——MapStruct 不会解析方法调用链，toC(A) 必须手动实现；
• ✅ 若需统一管理，可引入 Spring：用 @Mapper(componentModel = "spring")，然后通过 @Autowired 注入依赖 Mapper，语义更清晰；
• ? 对于复杂业务场景（如需条件跳过某层、动态选择策略），建议封装为 Service 层方法，而非强行塞进 Mapper。

✅ 总结

虽然 MapStruct 没有“自动链式映射”语法糖，但其设计哲学鼓励明确职责、组合复用。通过将 A→B 和 B→C 抽象为独立、可测试的 Mapper，并在上层手动组合，你不仅能避免重复编码复杂逻辑，还能获得更好的可读性、可测性和演进弹性。这比强行在一个 Mapper 中堆砌所有映射更符合工程实践。