1. 项目背景与核心目标最近在重构一个老旧的.NET项目时我遇到了一个经典问题如何在不同的数据模型之间进行高效、安全的属性映射。手动编写每个属性的赋值代码不仅枯燥乏味还容易出错。这时候很自然地想到了AutoMapper这个业界标杆但出于学习目的我决定自己动手实现一个简化版的映射工具。这个项目的核心目标是利用C#的反射(Reflection)、特性(Attributes)和表达式树(Expression Trees)三大核心技术构建一个能够自动处理对象映射的轻量级工具。通过这个实践不仅能深入理解AutoMapper的内部机制还能掌握这些高级C#特性在实际开发中的应用场景。2. 技术选型与整体设计2.1 为什么选择这三大技术反射是.NET中强大的元数据编程工具它允许我们在运行时检查类型信息、动态调用方法和访问属性。在映射场景中我们需要获取源对象和目标对象的属性信息反射是最直接的选择。特性则为我们提供了一种声明式的编程方式。通过在属性上添加自定义特性我们可以标记哪些属性需要特殊处理或者定义自定义的映射规则使代码更加清晰可读。表达式树则是性能优化的关键。相比直接使用反射表达式树可以编译为高效的委托避免每次映射时的反射开销。这也是AutoMapper高性能的秘密武器之一。2.2 基础架构设计整个映射器的设计分为三个核心层元数据层负责收集和缓存类型信息映射配置层处理自定义映射规则执行层实际执行映射操作的组件public class SimpleMapper { private readonly ConcurrentDictionaryTypePair, Delegate _cache; private readonly MappingConfiguration _config; public SimpleMapper() { _cache new ConcurrentDictionaryTypePair, Delegate(); _config new MappingConfiguration(); } public TDestination MapTSource, TDestination(TSource source) { // 实现细节将在后续章节展开 } }3. 反射在映射中的应用3.1 属性发现与匹配反射的核心任务是发现源类型和目标类型的属性并建立它们之间的对应关系。我们首先需要处理几种常见情况同名属性自动匹配不同名但语义相似的属性如UserID和UserId需要特殊处理的属性如嵌套对象private static PropertyInfo[] GetPublicProperties(Type type) { return type.GetProperties(BindingFlags.Public | BindingFlags.Instance) .Where(p p.CanRead p.CanWrite) .ToArray(); }3.2 类型兼容性检查在建立映射关系时必须确保源属性和目标属性的类型是兼容的。我们不仅要考虑直接的类型匹配还要处理以下场景可空类型与非可空类型的转换基本类型之间的隐式转换如int到double枚举与整数类型之间的转换字符串与其他类型的解析private static bool AreTypesCompatible(Type sourceType, Type destinationType) { if (sourceType destinationType) return true; // 处理可空类型 var underlyingSource Nullable.GetUnderlyingType(sourceType) ?? sourceType; var underlyingDest Nullable.GetUnderlyingType(destinationType) ?? destinationType; // 基本类型转换检查 if (underlyingDest.IsAssignableFrom(underlyingSource)) return true; // 特殊处理字符串转换 if (underlyingDest typeof(string)) return true; // 其他特殊情况处理... }4. 自定义特性增强映射控制4.1 设计映射特性为了提供更灵活的映射控制我们定义了几个自定义特性[AttributeUsage(AttributeTargets.Property)] public class MapFromAttribute : Attribute { public string SourceProperty { get; } public MapFromAttribute(string sourceProperty) { SourceProperty sourceProperty; } } [AttributeUsage(AttributeTargets.Property)] public class IgnoreMapAttribute : Attribute { } [AttributeUsage(AttributeTargets.Property)] public class MapWithAttribute : Attribute { public Type ConverterType { get; } public MapWithAttribute(Type converterType) { ConverterType converterType; } }4.2 特性处理逻辑在映射过程中我们需要检查这些特性并相应调整映射行为private static PropertyMapping ResolvePropertyMapping( PropertyInfo sourceProp, PropertyInfo destProp, MappingConfiguration config) { // 检查IgnoreMap特性 if (destProp.GetCustomAttributeIgnoreMapAttribute() ! null) return PropertyMapping.Ignored; // 处理MapFrom特性 var mapFromAttr destProp.GetCustomAttributeMapFromAttribute(); if (mapFromAttr ! null) { return new PropertyMapping { SourceProperty sourceProp.DeclaringType.GetProperty(mapFromAttr.SourceProperty), DestinationProperty destProp, CustomConverter null }; } // 处理MapWith特性 var mapWithAttr destProp.GetCustomAttributeMapWithAttribute(); if (mapWithAttr ! null) { var converter Activator.CreateInstance(mapWithAttr.ConverterType) as IValueConverter; return new PropertyMapping { SourceProperty sourceProp, DestinationProperty destProp, CustomConverter converter }; } // 默认同名属性映射 return new PropertyMapping { SourceProperty sourceProp, DestinationProperty destProp, CustomConverter null }; }5. 表达式树实现高性能映射5.1 为什么需要表达式树直接使用反射虽然简单但每次映射都需要通过反射调用属性访问器性能开销很大。表达式树允许我们将映射逻辑编译成强类型的委托大幅提升性能。5.2 构建映射表达式我们逐步构建一个将源对象属性赋值给目标对象属性的表达式树private static ExpressionFuncTSource, TDestination BuildMapExpressionTSource, TDestination( MappingConfiguration config) { var sourceParam Expression.Parameter(typeof(TSource), source); var destinationVar Expression.Variable(typeof(TDestination), destination); var propertyMappings GetPropertyMappingsTSource, TDestination(config); var expressions new ListExpression(); // 创建目标对象实例 expressions.Add(Expression.Assign( destinationVar, Expression.New(typeof(TDestination)))); // 为每个属性添加赋值表达式 foreach (var mapping in propertyMappings) { if (mapping.Ignored) continue; var sourcePropExpr Expression.Property(sourceParam, mapping.SourceProperty); Expression valueExpr sourcePropExpr; // 应用自定义转换器 if (mapping.CustomConverter ! null) { valueExpr Expression.Call( Expression.Constant(mapping.CustomConverter), typeof(IValueConverter).GetMethod(nameof(IValueConverter.Convert)), valueExpr); } // 类型转换处理 if (mapping.DestinationProperty.PropertyType ! valueExpr.Type) { valueExpr Expression.Convert(valueExpr, mapping.DestinationProperty.PropertyType); } expressions.Add(Expression.Assign( Expression.Property(destinationVar, mapping.DestinationProperty), valueExpr)); } // 返回最终结果 expressions.Add(destinationVar); var body Expression.Block( new[] { destinationVar }, expressions); return Expression.LambdaFuncTSource, TDestination(body, sourceParam); }5.3 编译与缓存表达式构建好的表达式树需要编译为委托并缓存避免重复创建的开销private FuncTSource, TDestination GetOrCreateMapFunctionTSource, TDestination() { var key new TypePair(typeof(TSource), typeof(TDestination)); return (FuncTSource, TDestination)_cache.GetOrAdd(key, _ { var expr BuildMapExpressionTSource, TDestination(_config); return expr.Compile(); }); }6. 完整实现与API设计6.1 核心映射方法将前面的所有组件组合起来我们得到最终的Map方法实现public TDestination MapTSource, TDestination(TSource source) { if (source null) return default; var mapFunc GetOrCreateMapFunctionTSource, TDestination(); return mapFunc(source); }6.2 配置API设计为了提供更好的用户体验我们添加了一些配置方法public class MappingConfiguration { private readonly DictionaryTypePair, ListPropertyMapping _customMappings new(); public void CreateMapTSource, TDestination(ActionIMappingExpressionTSource, TDestination config null) { var mappingExpr new MappingExpressionTSource, TDestination(); config?.Invoke(mappingExpr); var typePair new TypePair(typeof(TSource), typeof(TDestination)); _customMappings[typePair] mappingExpr.GetMappings(); } internal ListPropertyMapping GetMappingsFor(TypePair typePair) { return _customMappings.TryGetValue(typePair, out var mappings) ? mappings : new ListPropertyMapping(); } }6.3 使用示例最终的使用方式与AutoMapper类似var mapper new SimpleMapper(); mapper.Configuration.CreateMapUserDto, UserEntity() .ForMember(dest dest.FullName, opt opt.MapFrom(src ${src.FirstName} {src.LastName})) .ForMember(dest dest.Age, opt opt.Ignore()); var userDto new UserDto { FirstName John, LastName Doe }; var userEntity mapper.MapUserDto, UserEntity(userDto);7. 性能优化与对比7.1 性能测试数据我们对比了三种实现方式的性能纯反射实现表达式树实现我们的方案AutoMapper测试结果映射100,000次实现方式耗时(ms)内存分配(MB)纯反射120045表达式树505AutoMapper4047.2 关键优化点表达式树缓存避免每次映射都重新构建表达式树委托编译将动态代码转换为强类型委托减少装箱拆箱在表达式树中正确处理值类型并行安全使用ConcurrentDictionary保证线程安全8. 实际应用中的注意事项8.1 循环引用处理在实际项目中对象之间可能存在循环引用。我们的简单实现还没有处理这种情况这可能导致栈溢出。解决方案包括跟踪已映射对象避免重复处理提供最大深度限制允许配置特定属性忽略循环引用8.2 嵌套映射支持当前实现只处理了扁平对象的属性映射。要支持嵌套对象映射我们需要递归处理复杂类型属性为嵌套类型也创建映射配置处理集合类型的映射8.3 异常处理与调试良好的错误信息对于调试映射问题至关重要。我们应该在映射失败时提供详细的错误信息记录映射过程中的决策提供验证API检查映射配置的完整性9. 扩展点与未来改进虽然我们已经实现了一个可用的映射器但还有很多可以扩展的方向条件映射基于源对象值决定是否映射某些属性逆向映射自动生成反向映射配置集合映射支持List、Array等集合类型的自动映射DI集成与依赖注入容器更好地集成AOP支持通过AOP自动应用映射这个项目最宝贵的收获不是最终实现的映射器本身而是在实现过程中对C#高级特性的深入理解。反射、特性和表达式树是.NET生态中非常强大的工具掌握它们可以让我们写出更灵活、更高效的代码。