什么是AutoMapper?
AutoMapper是一個(gè)能自動完成對象與對象之間轉(zhuǎn)化的開源庫部翘;通常DTO(Data Transfer Object數(shù)據(jù)傳輸對象)與Model之間的常規(guī)轉(zhuǎn)化做法會使代碼相當(dāng)?shù)娜唛L,AutoMapper作者為了減少這種工作量,寫了這個(gè)開源庫孩等,使DTO與Model之間能夠自動的完成轉(zhuǎn)化。
在學(xué)習(xí)過程中查閱了很多資料满葛,幫助比較大的一片博文為:http://www.codeproject.com/Articles/61629/AutoMapper 全英文對我來說壓力還是挺大的昌罩,但是還是一點(diǎn)點(diǎn)啃下來了。
基礎(chǔ)使用方法:
public class DTO
{
public string userName {set; get;}
public string age {set; get;}
public string job {set; get;}
}
public class Model
{
public string userName {set; get;}
public string age {set; get;}
public string job {set; get;}
}
上述的DTO與Model饭冬,一般情況下使鹅,DTO為直接映射數(shù)據(jù)庫中的數(shù)據(jù),Model為交互數(shù)據(jù)昌抠,那么如何把兩著對象里的數(shù)據(jù)進(jìn)行映射呢患朱?
- 通常的做法為:
//DTO與Model之間可以這樣轉(zhuǎn)化,因?yàn)榈膶ο蟮膶傩远紴閟tring類型
DTO.userName = Model.userName;
DTO.age = Model.age ;
DTO.job = Model.job ;
- 使用AutoMapper轉(zhuǎn)化:
//首先需要先為DTO與Model之間定義一個(gè)映射關(guān)系
Mapper.CreateMap<DTO, Model>();
DTO dtoData = GetdtoDataFromDB();
Model modelData = Mapper.Map<DTO, Model>(dtoData );
這里的DTO對象就被AutoMapper自動轉(zhuǎn)化成了Model對象炊苫,所以modelData中的userName裁厅、age、job的值即為GetdtoDataFromDB()方法取出來的值侨艾。
遇到的坑點(diǎn)
在實(shí)際的項(xiàng)目中使用AutoMapper對DTO與Model進(jìn)行自動轉(zhuǎn)化的時(shí)候遇到了一個(gè)坑點(diǎn)执虹,其實(shí)也不算是坑點(diǎn),只是一個(gè)我沒有注意到的地方唠梨,這里做一個(gè)記錄袋励,加深自己的印象。
DTO與Model的結(jié)構(gòu)如下:
// DTO
public class DTO
{
public string userName {set; get;}
public string age {set; get;}
public string job {set; get;}
public AddressDTO address {set ; get;}
}
public class AddressDTO{
public string country {set; get;}
public string province {set; get;}
}
// Model
public class Model
{
public string userName {set; get;}
public string age {set; get;}
public string job {set; get;}
public AddressModel address {set ; get;}
}
public class AddressModel{
public string country {set; get;}
public string province {set; get;}
}
寫完了這個(gè)兩個(gè)對象当叭,于是便開始寫與上面的一樣開始用AutoMapper進(jìn)行自動轉(zhuǎn)化
Mapper.CreateMap<DTO, Model>();
DTO dtoData = GetdtoDataFromDB();
Model modelData = Mapper.Map<DTO, Model>(dtoData );
寫完了茬故,心里很高興,心里感嘆著AutoMapper的強(qiáng)大科展。結(jié)果項(xiàng)目一跑起來報(bào)錯均牢,報(bào)錯結(jié)果為:(圖片為另一篇博客貼來的)
從報(bào)錯結(jié)果分析,原因是我沒有配置正確才睹,如何解決這個(gè)問題呢徘跪?
很簡單甘邀,像這樣包含子對象之間的轉(zhuǎn)換,只要把子對象之間也使用AutoMapper來定義映射關(guān)系不就行了嗎垮庐?
Action
Mapper.CreateMap<DTO, Model>();
Mapper.CreateMap<AddressDTO , AddressModel >();//子對象映射關(guān)系
DTO dtoData = GetdtoDataFromDB();
Model modelData = Mapper.Map<DTO, Model>(dtoData );
這樣松邪,項(xiàng)目就成功的跑起來了,AutoMapper的一個(gè)好處之一:如果我們需要一個(gè)新的字段哨查,比如在DTO中新增一個(gè)
public string sex {set; get;}
這個(gè)時(shí)候如果是常規(guī)的寫法逗抑,我們需要在轉(zhuǎn)化的地方手動加上
DTO.sex = Model.sex;
當(dāng)項(xiàng)目越來越大的時(shí)候,我們做這種更改需要極其小心寒亥。
而使用AutoMapper來實(shí)現(xiàn)自動轉(zhuǎn)化邮府,只需要在DTO中與Model中添加需要新增的字段即可,避免了手寫代碼的風(fēng)險(xiǎn)溉奕。
最后
AutoMapper還有許多強(qiáng)大的功能褂傀,如自定義映射關(guān)系等;
今后學(xué)習(xí)過程中如果使用到加勤,也會以筆記的形式記錄下來仙辟。