AutoMapper三板斧：值转换器、条件映射、自定义解析器，复杂映射不再愁

写了几年.NET代码AutoMapper这玩意儿没少用。刚开始接触的时候就觉得——“哎呦这东西太爽了”不用再一行一行手动赋值一个Map全搞定。但用着用着就发现光会CreateMap可不够。遇到复杂情况简单配置根本搞不定要么报错要么映射出来的东西不是你要的。今天刚子就跟你聊聊我这些年踩坑踩出来的3个高级配置技巧。保证小白也能看懂。技巧一值转换器——搞定“类型对不上”啥时候用这个就是源属性和目标属性类型不一样的时候。举个例子你数据库里存的是decimal类型的金额比如123.45。但前端要展示带美元符号的字符串比如$123.45。你要是不用转换器就得在DTO里单独搞个字符串属性或者在映射之后手动格式化。麻烦不麻烦用值转换器就简单了public class CurrencyFormatter : IValueConverterdecimal, string { public string Convert(decimal source, ResolutionContext context) { return source.ToString(C2); // 输出 $123.45 } } // 配置 cfg.CreateMapOrder, OrderDto() .ForMember(dest dest.Amount, opt opt.ConvertUsing(new CurrencyFormatter()));每次碰到Order里的Amount要映射到OrderDto的AmountAutoMapper就会自动走这个转换逻辑。划重点值转换器的好处是能重复用。你可以在好几个地方用同一个转换器不用每个地方都写一遍格式化代码。但有个小坑值转换器只在普通映射时生效如果你用EF Core直接从数据库投影ProjectTo它不干活。这个记一下就行。技巧二条件映射——想清楚再动手这个技巧特别实用。简单说就是满足条件才映射不满足就跳过。举个例子你有一个用户实体年龄是int类型但目标DTO里年龄是uint无符号整数就是不能为负数。负数不能转成无符号整数对吧这时候就可以加个条件cfg.CreateMapUser, UserDto() .ForMember(dest dest.Age, opt opt.Condition(src src.Age 0));只有源年龄大于等于0时才映射。条件映射里还有一对孪生兄弟Condition和PreCondition它俩的区别就是谁先跑。PreCondition跑得更早在源值被拿出来之前就执行。PreCondition主要是为了省时间——如果你的源值解析非常耗时比如要查数据库可以在PreCondition里先判断是否满足条件不满足就直接跳过不用浪费时间。划重点条件映射别到处用。偶尔用一两个没问题但如果你发现到处都在写Condition多半是你的模型设计本身有问题回去改模型比补条件更省事。技巧三自定义值解析器——复杂逻辑的归宿值转换器适合解决“类型对不上”这种一对一的问题。但有些场景更复杂——比如你需要从源对象的好几个地方拿信息拼成一个目标属性或者逻辑太复杂一行代码写不下。这时候就要上自定义值解析器了。举个例子你要把Person里的FirstName名和LastName姓拼成FullName全名public class FullNameResolver : IValueResolverPerson, PersonDto, string { public string Resolve(Person source, PersonDto destination, string destMember, ResolutionContext context) { return ${source.FirstName} {source.LastName}; } } // 配置 cfg.CreateMapPerson, PersonDto() .ForMember(dest dest.FullName, opt opt.MapFromFullNameResolver());解析器的Resolve方法能拿到源对象、目标对象、目标成员名和上下文信息。这意味着你可以访问目标对象的其他属性来做复杂判断。划重点自定义解析器还有个隐藏好处——支持依赖注入。如果你的解析器里需要用到数据库、缓存啥的可以直接通过构造函数传进来。但注意要把Mapper配置成单例模式不然每个请求都建个新的服务器扛不住。一个真实案例三个技巧一起上说了这么多理论刚子给你来个真实的例子。有这样一个需求订单列表页面后端返回的Order实体里存的是decimal金额和DateTime时间但前端要展示带货币符号的字符串和格式化的日期。而且如果订单是取消状态金额那一栏直接显示“已取消”而不是金额数字金额超过1万的还要加个特殊标识。如果不用高级配置只能在DTO里单独搞字符串属性然后在Service层手写逻辑。代码又多又难维护每次改需求都得翻来覆去改好几个地方。用AutoMapper的高级技巧一个配置文件全搞定public class OrderProfile : Profile { public OrderProfile() { CreateMapOrder, OrderDto() // 金额映射走转换器 条件判断 解析器组合 .ForMember(dest dest.FormattedAmount, opt { // 条件订单状态是取消的话跳过金额转换逻辑 opt.Condition(src src.Status ! OrderStatus.Cancelled); // 再用转换器把 decimal 变成 $123.45 格式 opt.ConvertUsing(new CurrencyFormatter()); }) // 日期映射用值转换器搞定格式 .ForMember(dest dest.FormattedCreateTime, opt opt.ConvertUsing(new DateTimeFormatter(yyyy-MM-dd HH:mm))) // 超万金额标识用自定义解析器内部判断金额10000时追加标识 .ForMember(dest dest.AmountDisplay, opt opt.MapFromAmountDisplayResolver()); } }你看原来要在Service层写一大坨逻辑才能搞定的事儿现在全收进Profile里了。业务层代码干干净净就一行_mapper.MapOrderDto(order)。划重点把映射逻辑收进Profile里还有一个额外的好处——单元测试特别好写。你只需要测试Profile的配置对不对不用把Service层也扯进来测试用例又少又干净。最后刚子想说AutoMapper这个工具入门简单想玩溜真得花点功夫。今天讲的这三个技巧——值转换器、条件映射、自定义值解析器——都是我这些年实战总结出来的。学会了你就不用再被那些复杂的映射场景折磨了。记住能用配置解决的问题就别写到业务代码里。如果你觉得这篇文章有用点个赞、转给还在手写对象映射的兄弟。我是刚子一个写了六年代码的.NET程序员。咱们下回见