MapStruct如何有条件排除集合中theDate为过去时间的ChildDTO

架构老林

2026-8-15

MapStruct过滤列表中符合条件的元素

@Mapping注解无法直接实现集合元素的过滤逻辑，你可以通过以下两种方式实现需求：

方法一：自定义列表映射方法

在ParentMapper中声明默认方法，同时完成子实体到DTO的映射和过滤：

@Mapper(uses = {ChildMapper.class})
public interface ParentMapper {
    ParentDTO entityToDTO(ParentEntity parent);

    // 自定义映射+过滤逻辑
    default List<ChildDTO> mapAndFilterChildren(List<ChildEntity> children) {
        if (children == null) {
            return null;
        }
        return children.stream()
                .map(ChildMapper.INSTANCE::entityToDTO)
                .filter(childDTO -> childDTO.getTheDate().isAfter(Instant.now()))
                .collect(Collectors.toList());
    }
}

MapStruct会自动识别该方法，替代默认的列表映射逻辑，直接返回过滤后的子DTO列表。

方法二：使用@AfterMapping后置处理

先完成全量对象映射，再对ParentDTO中的子列表做过滤：

@Mapper(uses = {ChildMapper.class})
public interface ParentMapper {
    ParentDTO entityToDTO(ParentEntity parent);

    @AfterMapping
    default void filterPastDateChildren(@MappingTarget ParentDTO parentDTO) {
        List<ChildDTO> children = parentDTO.getChildren();
        if (children == null || children.isEmpty()) {
            return;
        }
        List<ChildDTO> filtered = children.stream()
                .filter(childDTO -> childDTO.getTheDate().isAfter(Instant.now()))
                .collect(Collectors.toList());
        parentDTO.setChildren(filtered);
    }
}

这种方式适合需要先完成全量映射，再做后续处理的场景。