[非专业翻译] 是对没有中文文档进行翻译的系列博客,文章由机翻和译者自己理解构成,和原文相比有所有不同,但意思基本一致。
因个人能力有限,如有谬误之处还请指正,多多包涵。
正文 防止循环引用当映射类型存在循环引用时,会导致 Mapster 试图递归映射循环引用并抛出 stackoverflow 异常。
如果想要映射循环引用或保留引用(例如指向同一个对象的两个属性),可以使用 PreserveReference 方法并将参数设置为 true 来实现这个需求:
TypeAdapterConfig<TSource, TDestination> .NewConfig() .PreserveReference(true);注意! Mapster 配置的是类型到类型,而不是每个层次结构,所以在使用时需要显示配置所有类型.
注意!PreserveReference 不支持对 ProjectTo EF IQueryable 的映射 !
映射深度 —— 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);