Mapperly项目中如何传递上下文信息给属性映射器

在对象映射场景中，有时我们需要在属性映射过程中访问源对象的其他属性或上下文信息。Mapperly作为一款高效的.NET对象映射代码生成器，提供了灵活的解决方案来处理这类需求。

问题背景

当使用Mapperly的MapProperty特性进行自定义属性映射时，默认情况下映射方法只能接收当前属性的值作为参数。例如在以下代码中：

[MapProperty(nameof(ConnectionConf.Options), nameof(ConnectionCreateRequest.Options), Use = nameof(MapOptionsToRequest))]
public partial ConnectionCreateRequest ConnectionConfToCreateRequest(ConnectionConf conf);

object? MapOptionsToRequest(IDictionary? options)
{
    // 这里只能访问options参数，无法访问ConnectionConf的其他属性
    return null;
}

MapOptionsToRequest方法只能接收到Options属性的值，而无法访问源对象ConnectionConf的其他属性，这在某些业务场景下会限制映射逻辑的灵活性。

解决方案

Mapperly提供了两种主要方式来解决这个问题：

1. 使用AfterMap结合属性忽略

这是更推荐的解决方案，具体实现如下：

[Mapper]
public partial class ConnectionMapper
{
    public partial ConnectionCreateRequest ConnectionConfToCreateRequest(ConnectionConf conf);
    
    [AfterMap]
    private void AfterMap(ConnectionConf source, ConnectionCreateRequest target)
    {
        // 在这里可以访问source的所有属性
        target.Options = ProcessOptions(source.Options, source.SomeOtherProperty);
    }
    
    private object? ProcessOptions(IDictionary? options, string someOtherValue)
    {
        // 处理逻辑
        return null;
    }
}

这种方法的好处是：

• 保持了代码的清晰性
• 可以访问源对象的所有属性
• 符合Mapperly的设计模式

2. 使用自定义映射方法

虽然不如第一种方法优雅，但在某些简单场景下也可以使用：

[Mapper]
public partial class ConnectionMapper
{
    public ConnectionCreateRequest MapConnection(ConnectionConf conf)
    {
        var request = MapToRequest(conf);
        request.Options = ProcessOptions(conf.Options, conf.SomeOtherProperty);
        return request;
    }
    
    private partial ConnectionCreateRequest MapToRequest(ConnectionConf conf);
    
    private object? ProcessOptions(IDictionary? options, string someOtherValue)
    {
        // 处理逻辑
        return null;
    }
}

最佳实践建议

1. 优先使用AfterMap：这是Mapperly专门设计用于处理映射后逻辑的机制，代码更清晰且易于维护。

2. 保持映射逻辑简单：复杂的业务逻辑应该放在映射器外部，映射器只负责数据转换。

3. 考虑性能影响：虽然AfterMap很方便，但在高性能场景下要评估其对性能的影响。

4. 文档化复杂映射：对于非直观的映射逻辑，添加清晰的注释说明业务规则。

通过这些方法，开发者可以灵活地在Mapperly映射过程中访问所需的上下文信息，同时保持代码的整洁和可维护性。