Mapperly 中基于源对象的复杂映射实现技巧

背景介绍

Mapperly 是一个高效的.NET对象映射代码生成器，它通过编译时生成映射代码来避免运行时反射带来的性能损耗。在实际开发中，我们经常遇到需要从源对象多个字段组合映射到目标对象单个字段的场景，传统的实现方式存在一些局限性。

传统实现方式的问题

在早期版本的 Mapperly 中，要实现从源对象多个字段组合映射到目标对象，开发者通常需要采用以下模式：

public Address OrderToAddress(Order order)
{
  var ret = MapToAddress(order);
  ret.FullName = string.Concat(order.FirstName, " ", order.LastName);
  return ret;
}

[MapperIgnoreTarget(nameof(Address.FullName))]
private partial Address MapToAddress(Order order);

这种方式存在几个明显缺点：

1. 需要额外的方法封装
2. 当使用严格映射模式时，必须显式忽略目标属性
3. 代码结构不够直观，映射逻辑分散

新特性：MapPropertyFromSourceAttribute

Mapperly 3.6.0 版本引入了 MapPropertyFromSourceAttribute 特性，提供了更优雅的解决方案：

[MapPropertyFromSource(nameof(Address.FullName))]
public partial Address OrderToAddress(Order order);

private string MapToFullName(Order order) => string.Concat(order.FirstName, " ", order.LastName);

特性优势

1. 声明式映射：直接在映射方法上声明需要特殊处理的属性
2. 代码简洁：避免了额外的封装方法
3. 可读性强：映射关系一目了然
4. 严格映射支持：不需要显式忽略目标属性

实现原理

MapPropertyFromSourceAttribute 特性允许开发者指定：

• 目标属性名称（支持单个或多个）
• 可选的字符串格式化
• 自定义格式提供程序
• 指定映射方法

在代码生成阶段，Mapperly 会识别这些特性并生成相应的映射逻辑，将整个源对象作为参数传递给指定的映射方法。

最佳实践

1. 简单字段组合：对于简单的字符串拼接等操作，可以直接在映射方法中实现
2. 复杂逻辑：对于复杂业务逻辑，建议使用单独的映射方法并通过 Use 参数引用
3. 多属性映射：当多个目标属性需要相同源对象时，可以使用数组形式指定多个目标属性

总结

Mapperly 的 MapPropertyFromSourceAttribute 特性为复杂对象映射场景提供了更优雅的解决方案，它简化了代码结构，提高了可读性，同时保持了 Mapperly 的高性能特性。这一改进特别适合需要从源对象多个字段组合映射到目标对象单个字段的场景，是 Mapperly 功能演进中的重要一步。