如何使用MapStruct将DTO中的嵌套对象映射为对象集合

针对你需要把BrandDTO中的单个CategoryDTO映射到Brand的Set<Category>集合的需求，以下是几种实用的实现方式：

方法1：通过@Mapping表达式直接转换 #

适合简单场景，直接在映射注解中用Java表达式完成单个对象到集合的包装：

首先定义基础的Category与CategoryDTO映射器：

@Mapper(componentModel = "spring") // 根据项目实际选择组件模型，如spring/cdi等
public interface CategoryMapper {
    Category toCategory(CategoryDTO categoryDTO);
}

然后定义Brand映射器，用表达式处理集合映射：

@Mapper(componentModel = "spring", uses = CategoryMapper.class)
public interface BrandMapper {

    @Mapping(target = "categories", expression = "java( brandDto.getCategory() == null ? java.util.Collections.emptySet() : new java.util.HashSet<>(java.util.Collections.singletonSet(categoryMapper.toCategory(brandDto.getCategory()))) )")
    @Mapping(target = "subcategories", ignore = true) // 按需处理其他字段
    Brand toBrand(BrandDTO brandDto);
}

备注：用new HashSet<>()包装是为了返回可变集合，若无需可变集合，直接用Collections.singletonSet()即可。

方法2：自定义默认映射方法（推荐） #

可读性更强，也方便扩展处理null等边界情况：

@Mapper(componentModel = "spring", uses = CategoryMapper.class)
public interface BrandMapper {

    @Mapping(target = "categories", source = "category")
    @Mapping(target = "subcategories", ignore = true)
    Brand toBrand(BrandDTO brandDto);

    // 自定义单个CategoryDTO转Set<Category>的逻辑
    default Set<Category> mapCategoryDtoToCategorySet(CategoryDTO categoryDTO) {
        Set<Category> categories = new HashSet<>();
        if (categoryDTO != null) {
            categories.add(categoryMapper.toCategory(categoryDTO));
        }
        return categories;
    }
}

MapStruct会自动识别并调用这个自定义方法，完成source="category"到target="categories"的映射，无需额外配置。

方法3：结合@IterableMapping（MapStruct 1.4+） #

适合需要精细控制集合映射规则的场景：

@Mapper(componentModel = "spring", uses = CategoryMapper.class)
public interface BrandMapper {

    @Mapping(target = "categories", source = "category")
    @Mapping(target = "subcategories", ignore = true)
    Brand toBrand(BrandDTO brandDto);

    @IterableMapping(nullValueMappingStrategy = NullValueMappingStrategy.RETURN_EMPTY)
    Set<Category> mapCategoryDtoToCategorySet(CategoryDTO categoryDTO);

    // 依赖基础转换方法
    Category toCategory(CategoryDTO categoryDTO);
}

nullValueMappingStrategy配置可以确保当输入categoryDTO为null时，返回空集合而非null，MapStruct会自动完成单个对象到集合的包装。

额外说明 #

• 若需要映射为List<Category>而非Set，只需将方法返回类型改为List<Category>，并将集合创建逻辑换成new ArrayList<>()即可。
• 确保项目已正确引入MapStruct依赖及注解处理器（如Maven/Gradle配置），避免编译时无法生成映射实现类。

内容的提问来源于stack exchange，提问作者Nandatō Kisame