我之前文章提到過 MediatR 的作者 Jimmy Bogard，他也是大名鼎鼎的對象映射框架 AutoMapper 的作者。AutoMapper 的功能強大，在 .NET 領域的開發者中有非常高的知名度和使用率。而今天老衣要提的是另外一款高性能對象映射框架：Mapster——它輕巧便捷，功能也非常強大，關鍵是性能很高——有可能是.NET領域性能最好的。

我們先來看看性能

與 AutoMapper 相比，Mapster 在速度和內存占用方面表現更加優秀 ，下面是官方給出的稍早版本 6.0 的性能對比表：

MethodMeanStdDevErrorGen 0Gen 1Gen 2Allocated

'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 看熱心網友做到中文翻譯版。

創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的可能是.NET领域性能最好的对象映射框架——Mapster的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。