[非專業翻譯] Mapster - 雙向 & 逆扁平映射

系列介紹

[非專業翻譯] 是對沒有中文文檔進行翻譯的系列博客，文章由機翻和譯者自己理解構成，和原文相比有所有不同，但意思基本一致。

因個人能力有限，如有謬誤之處還請指正，多多包涵。

正文

本文將說明 Mapster 如何配置雙向映射與逆扁平映射

雙向映射

如果需要 源到目標 和 目標到源 只進行一次配置，那么可以使用 ToWays 方法。

下面的配置的表現為：

• 源到目標時 dto.Code=poco.Id
• 目標到源時 poco.Id=dto.Code

TypeAdapterConfig<Poco, Dto>
    .NewConfig()
    .TwoWays()
    .Map(dto => dto.Code, poco => poco.Id);

注意，TwoWays 方法必須在配置映射之前進行調用，否則在調用 TwoWays 方法之前的配置為單向映射配置，之后的配置為雙向映射配置：

TypeAdapterConfig<Poco, Dto>
    .NewConfig()
    .Map(dto => dto.Foo, poco => poco.Bar)  //<-- Poco->Dto 時生效
    .TwoWays()
    .Map(dto => dto.Foz, poco => poco.Baz); //<-- 雙向映射生效

扁平化映射與逆扁平化映射

Mapster 默認將會把符合命名扁平化映射約束的成員進行映射。

例如，從 Staff 映射到 StaffDto 時，將會把 Supervisor 屬性的 Name 屬性映射到 StaffDto 的 SupervisorName 屬性：

class Staff {
    public string Name { get; set; }
    public Staff Supervisor { get; set; }
    ...
}

struct StaffDto {
    public string SupervisorName { get; set; }
}

但是如果想要 StaffDot 映射到 Staff 時，把 SupervisorName 映射到 Staff 的 Supervisor 屬性的 Name 屬性，那么就需要使用 Unflattening 方法進行顯示的映射配置，實現 poco.Supervisor.Name=dto.SupervisorName 的效果：

TypeAdapterConfig<StaffDto, Staff>.NewConfig()
    .Unflattening(true);

使用雙向映射配置實現逆扁平化映射

使用 Toways 方法可以實現與 Unflattening 方法同樣的效果：

• 源到目標時 dto.SupervisorName=poco.Supervisor.Name

• 目標到源時 poco.Supervisor.Name=dto.SupervisorName

TypeAdapterConfig<Staff, StaffDto>
    .NewConfig()
    .TwoWays();