[[375141]]

本文轉載自微信公眾號「碼農讀書」，作者碼農讀書。轉載本文請聯系碼農讀書公眾號。

AutoMapper 是一個基于約定的面向對象的映射器，它的功能常用于將一個 input 對象 轉成一個不同類型的 output 對象，input 和 output 對象之間的屬性可能相同也可能不相同，這一篇我們來一起研究一下 AutoMapper 的一些高級玩法。

安裝 AutoMapper

要想在項目中使用 AutoMapper ，需要通過 nuget 引用 AutoMapper 和 AutoMapper.Extensions.Microsoft.DependencyInjection 包，可以通過 Visual Studio 2019 的 NuGet package manager 可視化界面安裝 或者 通過 NuGet package manager 命令行工具輸入以下命令：

Install-Package AutoMapper 
Install-Package AutoMapper.Extensions.Microsoft.DependencyInjection 

配置 AutoMapper

一旦 AutoMapper 成功安裝之后，接下來就可以將它引入到 ServiceCollection 容器中，如下代碼所示：

public void ConfigureServices(IServiceCollection services) 
        {          
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); 
 
            services.AddAutoMapper(typeof(AuthorProfile)); 
        } 

使用 profiles 統一管理 mapping 信息

可以使用 profiles 來統一組織你的 mapping 信息，要創建 profile，需要實現 AutoMapper 提供的 Profile 類，然后在你剛才創建的 Profile 子類的構造函數中添加映射信息，下面的代碼展示了如何創建一個從 Proifle 繼承的 AuthorProfile 類以及相關信息。

public class AuthorProfile : Profile 
{ 
     public AuthorProfile() 
     { 
         CreateMap<AuthorModel, AuthorDTO>(); 
     } 
} 

接下來再看 AuthorModel 和 AuthorDTO 兩個對象的定義：

public class AuthorModel 
   { 
       public int Id 
       { 
           get; set; 
       } 
       public string FirstName 
       { 
           get;set; 
       } 
       public string LastName 
       { 
           get; set; 
       } 
       public string Address 
       { 
           get; set; 
       } 
   } 
 
   public class AuthorDTO 
   { 
       public int Id 
       { 
           get; set; 
       } 
       public string FirstName 
       { 
           get; set; 
       } 
       public string LastName 
       { 
           get; set; 
       } 
       public string Address 
       { 
           get; set; 
       } 

使用 ReverseMap()

值得注意的是，上面的示例是一種 單向流動，這是什么意思呢?舉個例子吧，下面是 單向流動 的一段代碼。

AutoMapper.Mapper.CreateMap<AuthorDTO, AuthorModel>(); 

有了這個 Map，接下來就可以輕松實現 AuthorDTO 到 AuthorModel 的轉換，代碼如下：

var authorModel = AutoMapper.Mapper.Map<AuthorModel>(author); 

假設因為某種原因，你需要將 authorModel 實例反轉成 authorDTO，這時你用了如下的代碼段。

var author = AutoMapper.Mapper.Map(authorModel); 

很遺憾，這種方式注定會拋出異常，這是因為 AutoMapper 并不知道如何實現 authorModel 到 authorDTO 的轉換，畢竟你沒有定義此種 map 的映射流向，那怎么解決呢?可以再定義一個 CreateMap 映射哈，其實沒必要，簡單粗暴的做法就是調用 ReverseMap 即可，實現代碼如下：

AutoMapper.Mapper.CreateMap<AuthorDTO, AuthorModel>().ReverseMap(); 

使用 ForMember() 和 MapFrom()

這一節我們繼續使用之前說到的 AuthorModel 和 AuthorDTO 類，下面的代碼片段展示了如何將 AuthorModel 轉成 AuthorDTO 。

var author = new AuthorModel();            
author.Id = 1; 
author.FirstName = "Joydip"; 
author.LastName = "Kanjilal"; 
author.Address = "Hyderabad"; 
var authorDTO = _mapper.Map<AuthorDTO>(author); 

現在假設我將 AuthorModel 中的 Address 改成 Address1，如下代碼所示：

public class AuthorModel 
   { 
       public int Id 
       { 
           get; set; 
       } 
       public string FirstName 
       { 
           get; set; 
       } 
       public string LastName 
       { 
           get; set; 
       } 
       public string Address1 
       { 
           get; set; 
       } 
   } 

然后在 AuthorProfile 中更新一下 mapping 信息，如下代碼所示：

public class AuthorProfile : Profile 
    { 
        public AuthorProfile() 
        { 
            CreateMap<AuthorModel, AuthorDTO>().ForMember(destination => destination.Address, map => map.MapFrom(source => source.Address1)); 
        } 
    } 

使用 NullSubstitute

何為 NullSubstitute 呢?大意就是在映射轉換的過程中，將input 為null 的屬性映射之后做自定義處理，比如在 ouput 中改成 No Data，下面的代碼展示了如何去實現。

AutoMapper.Mapper.CreateMap<AuthorModel, AuthorDTO>().ForMember(destination => destination.Address, opt => opt.NullSubstitute("No data")); 

mapping 的 AOP 攔截

考慮下面的兩個類。

public class OrderModel 
 { 
   public int Id { get; set; } 
   public string ItemCode { get; set; } 
   public int NumberOfItems { get; set; } 
 } 
 
 public class OrderDTO 
 { 
   public int Id { get; set; } 
   public string ItemCode { get; set; } 
   public int NumberOfItems { get; set; } 
 } 

可以使用 BeforeMap() 在 源對象 或者 目標對象 上執行一些計算或者初始化成員操作，下面的代碼展示了如何去實現。

Mapper.Initialize(cfg => { 
  cfg.CreateMap().BeforeMap((src, dest) => src.NumberOfItems = 0) 
}); 

當 mapping 執行完之后，可以在 目標對象 上 安插 AfterMap() 方法，下面的代碼展示了如何去實現。

public OrderDTO MapAuthor(IMapper mapper, OrderDTO orderDTO) 
        { 
            return mapper.Map<OrderModel, OrderDTO>(orderDTO, opt => 
            { 
                opt.AfterMap((src, dest) => 
                { 
                    dest.NumberOfItems = _orderService.GetTotalItems(src); 
               }); 
            }); 
        } 

使用嵌套映射

AutoMapper 同樣也可以使用嵌套映射，考慮下面的 domain 類。

public class Order 
    { 
        public string OrderNumber { get; set; } 
        public IEnumerable<OrderItem> OrderItems { get; set; } 
    } 
 
    public class OrderItem 
    { 
        public string ItemName { get; set; } 
        public decimal ItemPrice { get; set; } 
        public int ItemQuantity { get; set; } 
    } 

接下來再看一下 DTO 類。

public class OrderDto 
    { 
        public string OrderNumber { get; set; } 
        public IEnumerable<OrderItemDto> OrderItems { get; set; } 
    } 
 
    public class OrderItemDto 
    { 
        public string ItemName { get; set; } 
        public decimal ItemPrice { get; set; } 
        public int ItemQuantity { get; set; } 
    } 

最后看看如何在轉換的過程中使用 mapping 的。

var orders = _repository.GetOrders(); 
Mapper.CreateMap<Order, OrderDto>(); 
Mapper.CreateMap<OrderItem, OrderItemDto>(); 
var model = Mapper.Map<IEnumerable<Order>, IEnumerable<OrderDto>>(orders); 

AutoMapper 讓你用最小化的配置實現了對象之間的映射，同時也可以實現自定義的解析器來實現具有完全不同結構對象之間的映射，自定義解析器可以生成與目標對象具有相同結構的exchange，以便AutoMapper在運行時可以據其實現映射。

譯文鏈接：https://www.infoworld.com/article/3406800/more-advanced-automapper-examples-in-net-core.html