[非专业翻译] Mapster - 对象引用
系列介绍
[非专业翻译] 是对没有中文文档进行翻译的系列博客,文章由机翻和译者自己理解构成,和原文相比有所有不同,但意思基本一致。
因个人能力有限,如有谬误之处还请指正,多多包涵。
正文
本文将说明 Mapster 如何配置对象引用
防止循环引用
当映射类型存在循环引用时,会导致 Mapster 试图递归映射循环引用并抛出 stackoverflow 异常。
如果想要映射循环引用或保留引用(例如指向同一个对象的两个属性),可以使用 PreserveReference
方法并将参数设置为 true
来实现这个需求:
TypeAdapterConfig<TSource, TDestination>
.NewConfig()
.PreserveReference(true);
注意! Mapster 配置的是类型到类型,而不是每个层次结构,所以在使用时需要显示配置所有类型.
注意!
PreserveReference
不支持对ProjectTo
EFIQueryable
的映射 !
映射深度 —— MaxDepth
对于递归映射,可以尝试使用 MaxDepth
方法指定映射深度,将在到达指定映射深度时停止映射。并且 MaxDepth
支持对 IQueryable
的映射。
TypeAdapterConfig<TSource, TDestination>
.NewConfig()
.MaxDepth(3);
注意!
MaxDepth
映射深度最小应该为 1,深度为1将映射对象本身成员,不继续映射嵌套对象的成员。MaxDepth
未限制最大深度,但不应该将深度设置太大,因为每增加一级深度就会生成一个映射逻辑,若深度过大会导致大量的内存占用。
浅拷贝
Mapster 默认会递归映射嵌套对象。可以通过 ShallowCopyForSameType
方法将参数设置为true
来进行浅拷贝:
TypeAdapterConfig<TSource, TDestination>
.NewConfig()
.ShallowCopyForSameType(true);
大对象映射
为了优化性能,Mapster 会尝试内联类映射。如果映射的模型很复杂,那么这个过程将花费很多时间。
可以通过调用 AvoidInlineMapping
方法跳过内联过程:
TypeAdapterConfig.GlobalSettings.Default
.AvoidInlineMapping(true);