Mapstruct列表嵌套对象映射问题：避免全量构建方法

MapStruct对嵌套集合的映射需要拆分到每个对象层级单独定义映射规则，而非在主映射器里写链式路径。以下是最优实现方式：

1. 定义Attribute层级的映射器 #

处理属性名不一致的核心映射逻辑：

@Mapper
public interface AttributeContractMapper {
    @Mapping(target = "idContract", source = "idCImpl")
    @Mapping(target = "nameContract", source = "nameImpl")
    AttributeContract mapFrom(AttributeImpl attributeImpl);
}

2. 定义Item层级的映射器 #

引用Attribute映射器，让MapStruct自动生成列表映射的实现：

@Mapper(uses = AttributeContractMapper.class)
public interface ItemContractMapper {
    ItemContract mapFrom(ItemImpl itemImpl);
    
    // MapStruct会自动实现List的映射逻辑，无需手动编写stream代码
    List<ItemContract> mapFromList(List<ItemImpl> itemImplList);
}

3. 定义主Response映射器 #

引用Item映射器，MapStruct会自动处理items列表的嵌套映射：

@Mapper(uses = ItemContractMapper.class)
public interface ResponseContractMapper {
    ResponseContractClass mapFrom(ResponseImplClass response);
}

为什么之前的写法无效？ #

MapStruct不支持items.attribute.idContract这种针对集合元素的链式映射语法，因为集合是批量处理的，必须为每个单个对象（ItemImpl→ItemContract、AttributeImpl→AttributeContract）定义映射规则，MapStruct才会自动遍历集合并应用这些规则。

方案优势 #

• 无需手动编写流式处理的默认方法，避免大量重复的stream代码
• 每个层级的映射规则独立，便于维护和修改（比如后续新增属性，只需要在对应层级的映射器里添加@Mapping）
• MapStruct自动生成高效的映射代码，性能优于手动编写的stream逻辑

内容的提问来源于stack exchange，提问作者bolo