[非专业翻译] Mapster - 映射配置验证和编译

系列介绍

[非专业翻译] 是对没有中文文档进行翻译的系列博客，文章由机翻和译者自己理解构成，和原文相比有所有不同，但意思基本一致。

因个人能力有限，如有谬误之处还请指正，多多包涵。

正文

本文将说明 Mapster 中的映射配置验证和编译

为了在单元测试中验证映射，并帮助处理 "Fail Fast" 情况，添加了以下严格映射模式。

显式映射

通过修改配置实例 requireExplicitMapping 值决定是否开启强制显示映射。

当 requireExplicitMapping 值为 true 时，所有类型映射必须显式配置，即使非常简单：

// 默认值为: "false"
TypeAdapterConfig.GlobalSetTings.requireExplicitMapping = true;
// 当你必须为每个类有一个显式的配置，即使它只是:
TypeAdapterConfig<source, DesTination>.NewConfig();

检查目标类型程序

通过修改配置实例 requireDesTinationMembersource 值决定是否开启强制目标类型成员检查。

当 requireDesTinationMembersource 值为 true 时，所有目标类型的字段必须与源类型字段保持一致或显示的指定映射或忽略成员：

// 默认值为: "false"
TypeAdapterConfig.GlobalSetTings.requireDesTinationMembersource = true;

验证映射配置

调用 TypeAdapterConfig<source, DesTination>.NewConfg() 的 Compile 方法将验证特定类型的映射配置是否存在错误；

调用配置实例的 Compile 方法以验证配置实例中的映射配置是否存在错误；

另外，如果启用了显式映射 , 它还将包含没有在映射器中注册的类的错误。

// 验证特定配置
var config = TypeAdapterConfig<source, DesTination>.NewConfig();
config.Compile();

// 验证整个配置实例的配置
TypeAdapterConfig<source, DesTination>.NewConfig();
TypeAdapterConfig<source2, DesTination2>.NewConfig();
TypeAdapterConfig.GlobalSetTings.Compile();

配置编译

@H_172_4@mapster 将在第一次调用映射时自动编译：

var result = poco.Adapt<Dto>();

你也可以通过调用配置实例或特定映射配置的Compile 方法编译映射：

// 全局配置实例
TypeAdapterConfig.GlobalSetTings.Compile();

// 配置实例
var config = new TypeAdapterConfig();
config.Compile();

// 特定配置
var config = TypeAdapterConfig<source, DesTination>.NewConfig();
config.Compile();

推荐在程序添加映射配置完成后调用一次 Compile 方法，可以快速验证映射配置中是否存在错误，而不是在运行到某一行业务代码时触发错误降低效率。