.NET Core 5使用AutoMapper实现复杂嵌套对象映射方案咨询

涉及模型定义 #

public class Root
{
    public List<Quote> Quotes { get; set; }
    public DateTime RequestDate { get; set; }   
}

public class Quote
{
    public double Price { get; set; }
    public string FromCode { get; set; }
    public string ToCode { get; set; }
}

public class BaseModel
{
    public int Id { get; set; }
    public double Ask { get; set; }  
    // 映射自Quote.Price
    public ChildModel FromId { get; set; }  
    // 通过Quote.FromCode匹配ChildModel.Code得到对应实例
    public ChildModel ToId { get; set; } 
    // 通过Quote.ToCode匹配ChildModel.Code得到对应实例
    public DateTime LastRequestDate { get; set; } 
    // 映射自所属Root的RequestDate，同Root下所有Quote映射后该值一致
}

public class ChildModel
{
    public int Id { get; set; }
    public string Code { get; set; }
}

核心需求 #

• 输入为List<Root> + 独立的List<ChildModel>，输出为List<BaseModel>
• 映射时需要把每个Root下的所有Quote展开为单独的BaseModel记录，同时携带Root的RequestDate
• 根据Quote的FromCode、ToCode从传入的ChildModel集合中匹配对应实例，赋值给导航属性

原有方案问题 #

直接配置ValueTuple的单元映射后直接传入集合调用无法生效，原因是AutoMapper不会自动拆解嵌套集合、跨层级组合上下文参数。可运行的自定义转换器方案存在三个明显问题：

• 手动计算列表索引赋值LastRequestDate，逻辑脆弱易出错
• 每次匹配ChildModel都用FirstOrDefault遍历全集合，数据量大时性能差
• 映射逻辑拆分为Profile和自定义Converter两部分，结构零散不好维护

优化后实现 #

1. AutoMapper Profile配置 #

所有逻辑收敛在Profile中，不需要额外定义独立的类型转换器类：

public class AutoMapperProfiles : Profile
{
    public AutoMapperProfiles()
    {
        // 配置单条扁平化数据到BaseModel的映射规则
        CreateMap<(Quote quote, DateTime requestDate, IReadOnlyDictionary<string, ChildModel> childLookup), BaseModel>()
            .ForMember(dest => dest.Ask, opt => opt.MapFrom(src => src.quote.Price))
            .ForMember(dest => dest.LastRequestDate, opt => opt.MapFrom(src => src.requestDate))
            .ForMember(dest => dest.FromId, opt => opt.MapFrom(src => 
                src.childLookup.TryGetValue(src.quote.FromCode, out var fromChild) ? fromChild : null))
            .ForMember(dest => dest.ToId, opt => opt.MapFrom(src => 
                src.childLookup.TryGetValue(src.quote.ToCode, out var toChild) ? toChild : null));

        // 配置源元组到目标List的转换逻辑
        CreateMap<(List<Root> roots, List<ChildModel> children), List<BaseModel>>()
            .ConvertUsing((source, _, context) =>
            {
                if (source.roots == null || source.children == null)
                    return new List<BaseModel>();
                
                // *提前将ChildModel转为Code为键的字典，匹配复杂度从O(n)降到O(1)*
                var childLookup = source.children
                    .GroupBy(c => c.Code)
                    .ToDictionary(g => g.Key, g => g.First(), StringComparer.Ordinal);
                
                // 用SelectMany直接拍平嵌套的Root和Quote，不需要手动计算索引
                var flattenSource = source.roots
                    .SelectMany(root => root.Quotes
                        .Select(quote => (quote, root.RequestDate, childLookup)));
                
                return context.Mapper.Map<List<BaseModel>>(flattenSource);
            });
    }
}

2. 业务层调用 #

和原有调用方式完全一致，不需要修改业务代码：

List<BaseModel> result = _mapper.Map<List<BaseModel>>((listOfRoot, listOfChildModel));

方案优势 #

• 去掉了独立的自定义转换器类，所有映射规则集中在Profile中，维护成本低
• 用SelectMany自动展开嵌套集合，避免手动计算索引的脆弱逻辑
• 提前构建ChildModel的查找字典，匹配性能大幅提升，同时增加了空值防护，匹配不到对应Code时不会抛出空引用异常
• 完全复用AutoMapper的集合映射能力，代码更简洁符合AutoMapper的使用规范

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