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

玩雙截棍的熊貓發表於2021-07-01

[非專業翻譯] 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();

相關文章