我之前文章提到过 MediatR 的作者 Jimmy Bogard，他也是大名鼎鼎的对象映射框架 AutoMapper 的作者。AutoMapper 的功能强大，在 .NET 领域的开发者中有非常高的知名度和使用率。而今天老衣要提的是另外一款高性能对象映射框架：Mapster——它轻巧便捷，功能也非常强大，关键是性能很高——有可能是.NET领域性能最好的。
我们先来看看性能
与 AutoMapper 相比，Mapster 在速度和内存占用方面表现更加优秀 ，下面是官方给出的稍早版本 6.0 的性能对比表：
| Method | Mean | StdDev | Error | Gen 0 | Gen 1 | Gen 2 | Allocated |
|---|---|---|---|---|---|---|---|
| 'Mapster 6.0.0' | 108.59 ms | 1.198 ms | 1.811 ms | 31000.0000 | - | - | 124.36 MB |
| 'Mapster 6.0.0 (Roslyn)' | 38.45 ms | 0.494 ms | 0.830 ms | 31142.8571 | - | - | 124.36 MB |
| 'Mapster 6.0.0 (FEC)' | 37.03 ms | 0.281 ms | 0.472 ms | 29642.8571 | - | - | 118.26 MB |
| 'Mapster 6.0.0 (Codegen)' | 34.16 ms | 0.209 ms | 0.316 ms | 31133.3333 | - | - | 124.36 MB |
| 'ExpressMapper 1.9.1' | 205.78 ms | 5.357 ms | 8.098 ms | 59000.0000 | - | - | 236.51 MB |
| 'AutoMapper 10.0.0' | 420.97 ms | 23.266 ms | 35.174 ms | 87000.0000 | - | - | 350.95 MB |
从表中我们可以看出，即使在不使用高性能组件的情况下它的性能都可以获得4倍于AutoMapper，却只需要1/3左右的内存占用，而在使用Roslyn Compiler、FEC (FastExpressionCompiler)、Code generation等组件后可以再进一步提升2-3倍的性能。Code generation 方式几乎就是这个事儿极限了。你还有更快的手段吗？
在实际项目中的基本使用
首先从 Nuget 中引用最新版本的 Mapster 包：
dotnet add package Mapster对象映射最多的场景就是两个实体定义的属性名是重叠对应的，那么此时的基本用法就非常简单：
var destObject = sourceObject.Adapt<Destination>();「注意」我说的是实体定义，没有只限制类定义。Class、Record（有点小限制注意查阅官方文档）、Interface 等各种形式都可以哦，这是我非常喜欢的。当然了你的源是IQueryable的也可以！
不是类也不是接口，只是基本的简单类型是否可以呢？也可以！
var s = 123.Adapt<string>(); // 等同于: 123.ToString();列表、数组、集合、包括各种接口的字典之间的映射，也可以: IList<T>, ICollection<T>, IEnumerable<T>, ISet<T>, IDictionary<TKey, TValue> 等等都可以！
只要C#支持类型转换的类型，那么在 Mapster 中也同样支持转换，而且像枚举与字符串之间的转换，.NET 自带的方式性能稍慢，Mapster也针对性的做了优化，所以你实际生产中绝大部分就是类似上面这么一行代码就行了，够简单便捷吧 ：D
在某些情况下，需要依赖注入，Mapster 提供了 IMapper 和 Mapper 来满足这个需求：
var result = mapper.Map<TDestination>(source);映射配置
现实项目中难免会有一些自定义映射的需求，Mapster提供了很强大的映射配置机制，可以通过映射配置解决你各种灵活需求。
我们可以使用 TypeAdapterConfig<TSource, TDestination>.NewConfig() 或 TypeAdapterConfig<TSource, TDestination>.ForType() 配置类型映射；
「注意」当调用 NewConfig 方法时，将会覆盖已存在的类型映射配置。
TypeAdapterConfig<TSource, TDestination>.NewConfig().Ignore(dest => dest.Age).Map(dest => dest.FullName,src => string.Format("{0} {1}", src.FirstName, src.LastName));当然了你想让自己配置全局有效，可以通过对 TypeAdapterConfig.GlobalSettings 进行设置处理。
你有一些场景需要有条件规则？没问题，可以通过When方法来实现：
TypeAdapterConfig.GlobalSettings.When((srcType, destType, mapType) => srcType == destType).Ignore("Id");上面这个配置的意思是，应用全局范围当任何一个映射的源类型和目标类型相同时，不映射 Id 属性。
新版本中对接口只读属性映射的增强
最近刚刚发布对 Mapster 7.3.0 带来了一些新的增强：
Switch expression by @SergerGood in #334
Upgrade packages by @SergerGood in #333
Include .NET 6.0 as Target Framework for Mapster.Tool by @kaizen365 in #390
Updated Sample Code in Readme by @CoSJay in #379
Simplify packaging and publishing NuGet packages, remove old framework monikers and upgrade to C# 10.0 by @andrerav in #405
Add ability to compile all mappings and then throw AggregateException by @MisterOzzy in #363
Init read-only properties when mapping with a non-readonly interface fixes #374 by @andrei-traktatovich in #375
其中最后一下对接口的只读属性映射增强，是我非常喜欢的，解决了在实际项目中的设计需求，省了不少事儿。
public interface ITarget
{int GetOnlyProperty {get;}int NormalProperty {get;set;}
}
public interface ITargetWithGetSetProperties
{int GetOnlyProperty {get;}int NormalProperty {get;set;}
}上面这个代码中场景中，如果ITarget类型的对象的属性 GetOnlyProperty 带有一个非 0 值，并想 Map 为 ITargetWithGetSetProperties 类型的对象时，老版本会在映射后目标对象的GetOnlyProperty保留int类型的默认值0，没做任何映射，新版本中解决了这个问题！
你可能会问“为什么会有这个需求？”，嗯，一个原因是因为接口可以多继承，而类只能单一继承，你品品，细品…… ：D
其他
微信公众号文章不适合详细展开讨论和分享，本文主要是抛砖引玉。想详细了解这个框架的可以到官方代码库中去看一下 https://github.com/MapsterMapper/Mapster ，如果说英文阅读有点困难，可以到 https://github.com/rivenfx/Mapster-docs 看热心网友做到中文翻译版。
![[cocos2d]修改富文本文本和高度](http://pic.xiahunao.cn/[cocos2d]修改富文本文本和高度)
