Mapperly项目中处理Google.Protobuf.WellKnownTypes类型映射的技术方案

在gRPC开发过程中，我们经常会遇到需要将Protocol Buffers定义的数据类型与C#实体类进行相互转换的场景。Mapperly作为一款高效的.NET对象映射工具，虽然原生不支持第三方类型库的直接映射，但开发者可以通过自定义映射方法来解决这个问题。

问题背景

当使用gRPC进行项目开发时，Protocol Buffers的Well-Known Types（如BoolValue、Int32Value等）与C#的可空类型（如bool?、int?等）之间存在对应关系。这些Wrapper类型在实际映射过程中可能会遇到转换困难。

解决方案

Mapperly提供了用户自定义方法的功能，允许开发者针对特定类型编写自己的映射逻辑。对于Google.Protobuf.WellKnownTypes与C#原生类型之间的转换，我们可以通过以下方式实现：

1. 为每个需要转换的类型对编写静态扩展方法
2. 在Mapperly映射配置中引用这些方法
3. 让Mapperly在生成代码时自动调用这些自定义转换逻辑

实现示例

以下是一个典型的BoolValue与bool?之间转换的实现示例：

public static partial class ProtobufTypeMapper
{
    // 自定义BoolValue到bool?的转换
    public static bool? ToNullableBool(this BoolValue value)
    {
        return value?.Value;
    }

    // 自定义bool?到BoolValue的转换
    public static BoolValue ToBoolValue(this bool? value)
    {
        return value.HasValue ? new BoolValue { Value = value.Value } : null;
    }
}

然后在Mapperly的映射配置中：

[Mapper]
public static partial class DtoMapper
{
    public static partial EntityDto ToDto(this Entity entity);
    
    [UserMapping(Default = true)]
    private static BoolValue Map(bool? source) => source.ToBoolValue();
    
    [UserMapping(Default = true)]
    private static bool? Map(BoolValue source) => source.ToNullableBool();
}

扩展建议

对于更复杂的场景，开发者可以考虑：

1. 创建一个专门的工具类集中管理所有Well-Known Types的转换方法
2. 为常用类型组合编写泛型转换器
3. 考虑性能优化，特别是在高频调用的场景下
4. 添加适当的空值处理逻辑，确保健壮性

通过这种方式，开发者可以充分利用Mapperly的高效代码生成能力，同时又能灵活处理各种特殊类型的映射需求，实现Protocol Buffers类型与C#类型之间的无缝转换。