首页
/ Mapperly 4.2.0版本发布:更智能的对象映射工具

Mapperly 4.2.0版本发布:更智能的对象映射工具

2025-06-15 18:01:09作者:蔡丛锟

项目简介

Mapperly是一个基于Roslyn源代码生成器的.NET对象映射工具,它通过在编译时生成映射代码来提供高性能的对象转换功能。相比传统的运行时反射映射方案,Mapperly生成的代码直接编译到程序集中,完全避免了反射带来的性能开销,同时提供了强大的类型检查和编译时验证能力。

新版本核心特性解析

枚举映射策略的精细化控制

4.2.0版本引入了对枚举类型映射策略的独立配置能力。开发者现在可以为枚举类型单独指定RequiredMappingStrategy,而不影响其他类型的映射行为。这一改进特别适合那些需要特殊处理枚举转换的场景,比如:

[Mapper(RequiredMappingStrategy = RequiredMappingStrategy.Target)]
public partial class Mapper
{
    [MapEnum(RequiredMappingStrategy = RequiredMappingStrategy.Source)]
    public partial CarDto Map(Car car);
}

空值处理的增强

新版本在空值处理方面做了多项改进:

  1. 新增了对NotNullIfNotNull属性的支持,该属性会添加到生成的映射方法上,帮助编译器进行更精确的null检查分析
  2. 改进了查询映射场景下的空值处理逻辑,不再生成不必要的空值合并运算符
  3. 修复了嵌套容器中可空成员的初始化问题

现有目标对象映射支持

4.2.0版本新增了对现有目标对象映射的支持,这意味着开发者现在可以将源对象映射到一个已经存在的目标对象实例上,而不是每次都创建新实例。这对于性能敏感场景特别有价值。

[Mapper]
public partial class Mapper
{
    public partial void MapToExisting(Source source, Destination destination);
}

诊断功能的增强

新版本改进了映射诊断功能:

  1. 新增了对null不匹配情况的诊断
  2. 优化了必需初始化成员的映射检查,现在只对真正需要初始化的成员进行诊断
  3. 修复了枚举值检查映射中nameof表达式的正确性问题

性能优化

4.2.0版本在性能方面做了几项重要改进:

  1. 查询映射场景下不再应用深度克隆,减少了不必要的性能开销
  2. 改进了查询映射的代码生成,避免生成冗余的null检查逻辑
  3. 通过支持现有目标对象映射,减少了对象分配次数

开发者体验改进

新版本在开发者体验方面也有显著提升:

  1. 新增了对FromTo方法转换的支持,提供了更灵活的映射配置方式
  2. 改进了用户实现方法的null检查提示
  3. 修复了内联用户实现方法中全局别名缺失的问题

升级建议

对于正在使用Mapperly的项目,升级到4.2.0版本可以带来更好的性能和更丰富的功能。特别推荐以下场景考虑升级:

  • 需要精细控制枚举映射行为的项目
  • 大量使用查询映射的性能敏感应用
  • 需要将数据映射到现有对象实例的场景
  • 希望获得更精确null检查分析的项目

升级过程通常只需更新NuGet包版本即可,但建议开发者检查项目中是否存在依赖旧版本行为的代码,特别是与null处理和枚举映射相关的部分。

登录后查看全文
热门项目推荐