MapStruct中集合映射时传递额外上下文参数的指南

public interface MyMapper {

    // 映射单个MyOM到MyEntity，并设置id
    @Mapping(target = "id", expression = "java(id)")
    MyEntity map(MyOM om, String id);

    // 如何将id参数从dtos列表映射传播到每个map()调用？
    List<MyEntity> mapDTOs(List<MyOM> dtos, String id);
}

import org.mapstruct.Context;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;

@Mapper(componentModel = "spring") // 示例，可根据需要调整
public interface MyMapper {

    // 映射单个MyOM到MyEntity，并设置id
    @Mapping(target = "id", expression = "java(id)")
    MyEntity map(MyOM om, String id);

    // 使用@Context标记id参数，表示其为上下文参数，需要向下传播
    // 注意：此处不应再有@Mapping注解来处理id，因为它是上下文参数
    List<MyEntity> mapDTOs(List<MyOM> dtos, @Context String id);
}

import org.mapstruct.Context;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;

// 假设我们有MyOM和MyEntity类定义
// public class MyOM { private String value; /* getter/setter */ }
// public class MyEntity { private String id; private String value; /* getter/setter */ }

@Mapper(componentModel = "spring")
public interface MyMapper {

    // 1. 原始的单对象映射方法，用于将MyOM映射到MyEntity，并设置一个非上下文的id
    @Mapping(target = "id", expression = "java(id)")
    MyEntity map(MyOM om, String id);

    // 2. 集合映射方法，接收一个@Context注解的id参数
    List<MyEntity> mapDTOs(List<MyOM> dtos, @Context String id);

    // 3. 关键的默认代理方法：
    //    它接收一个@Context注解的id参数，并显式调用上面的map方法，
    //    确保@Context参数被正确传递到map方法的id参数上。
    default MyEntity mapContext(MyOM om, @Context String id) {
        return map(om, id);
    }
}

// MyOM.java
public class MyOM {
    private String value;

    // Getters and Setters
    public String getValue() { return value; }
    public void setValue(String value) { this.value = value; }
}

// MyEntity.java
public class MyEntity {
    private String id;
    private String value;

    // Getters and Setters
    public String getId() { return id; }
    public void setId(String id) { this.id = id; }
    public String getValue() { return value; }
    public void setValue(String value) { this.value = value; }
}

// MyMapper.java
import org.mapstruct.Context;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.factory.Mappers;

@Mapper // 默认使用Default componentModel，也可指定如componentModel = "spring"
public interface MyMapper {

    MyMapper INSTANCE = Mappers.getMapper(MyMapper.class);

    @Mapping(target = "id", expression = "java(id)")
    MyEntity map(MyOM om, String id);

    List<MyEntity> mapDTOs(List<MyOM> dtos, @Context String id);

    default MyEntity mapContext(MyOM om, @Context String id) {
        return map(om, id);
    }
}

// 演示如何使用
import java.util.Arrays;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<MyOM> oms = Arrays.asList(new MyOM(), new MyOM());
        oms.get(0).setValue("Value1");
        oms.get(1).setValue("Value2");

        String contextId = "GLOBAL_ID_XYZ";

        List<MyEntity> entities = MyMapper.INSTANCE.mapDTOs(oms, contextId);

        for (MyEntity entity : entities) {
            System.out.println("Entity ID: " + entity.getId() + ", Value: " + entity.getValue());
        }
        // 预期输出：
        // Entity ID: GLOBAL_ID_XYZ, Value: Value1
        // Entity ID: GLOBAL_ID_XYZ, Value: Value2
    }
}