註:本系列文章的程式碼可以在這裡下載。
在上一篇文章中我們建構出了完整的應用場景,包括我們的Model、Dto以及它們之間的轉換規則。下面就可以捲起袖子,開始我們的AutoMapper之旅了。
【二】以Convention方式實現零配置的物件映射
我們的AddressDto和Address結構完全一致,且欄位名稱也完全相同。對於這樣的型別轉換,AutoMapper為我們提供了Convention,正如它的官網上所說的:
引用
AutoMapper uses a convention-based matching algorithm to match up source to destination values。的只是將要對應的兩個型別告訴AutoMapper(呼叫Mapper類別的Static方法CreateMap並傳入要映射的類型):
C#程式碼
C#代碼
AddressDto dto = new AddressDto
City = "Beijing", Street = "Dongzhimen Street", PostCode = "100001" }; Address address = Mapper.MapC#代碼
Address address = Mapper.Map
address.Street.ShouldBeNull();
address.PostCode.ShouldBeNull();
。
C#代碼
Address address = Mapper.Map
address.ShouldBeNull(); p);
address.ShouldBeNull(); 映射具有相同字段名的複雜類型的時候還是具有相當大的威力的。
例如,考慮我們的BookStoreDto到BookStore的映射,兩者的欄位名稱完全相同,只是欄位的類型不一致。如果我們定義了BookDto到Book的映射規則,再加上上述Convention方式的AddressDto到Address的映射,就可以用「零配置」實現BookStoreDto到BookStore的映射了:C#
IMapping , Book> expression = Mapper.CreateMap
// Define mapping rules from BookDto to
Mapper.CreateMap
接著我們就可以直接轉換BookStoreDto了:
名稱 = “我的商店”,
地址 = 新 AddressDto
{
城市 = “北京”
},
圖書= 新列表
{
新BookDto {Title = “ Restful Web 服務"},
new BookDto {Title = “Ruby Rails”},
}
};
BookStore bookStore = Mapper.Map
bookStore.Name.ShouldEqual ("我的商店");
bookStore.Address.City.ShouldEqual("北京");
bookStore.Books.Count.ShouldEqual(2);
bookStqual. "RESTful Web 服務"); bookStore.Books.Last().Title.ShouldEqual("Ruby for Rails");【前面定義類型間的簡單映射規則
我們學習了約定的方式,監聽的說還是有很多類型間的映射是無法透過簡單的約定方式來做的,這時候就需要我們使用配置了。還好我們的配置是在程式碼中以「強型別」的方式來寫的,比寫繁瑣易錯的xml方式是要好的多了。
先來看看BookD到Publisher的映射。
回顧前文定義的規則:BookDto.Publisher -> Publisher.Name。
在AutoMapperzhong,我們可以這樣映射:
AutoMapper使用ForMember來指定每個欄位的對應規則:
引用
還好有強大的lambda表達式,規則的定義簡單明了。
另外,我們還可以使用ConstructUsing的方式一次定義好所有欄位的映射規則。例如我們要定義BookD到第一作者(Author)的ContactInfo的映射,使用ConstructUsing的方式,我們可以:
C#代碼
map.ConstructUsing(s => new ContactInfo
熟悉的方式來使用了:
C#代碼
例如前面提到的AddressDto到Address的映射,假如AddressDto的字段Country不叫Country叫CountryName,那麼在寫AddressDto到Address的映射規則時,只需要:
C# CreateMap