در این مقاله که بخشی دیگر از سری آموزش جامع AutoMapper از وبسایت پرووید می باشد در رابطه با نگاشت معکوس و یا reverse mapping در AutoMapper صحبت خواهیم کرد. درک reverse mapping یکی از مهمترین مباحث مربوط به استفاده از AutoMapper می باشد. برای درک هرچه بهتر reverse mapping توصیه میکنیم حتماً قسمت های قبلی مربوط به این آموزش رو مطالعه کنید.
در واقع reverse mapping یک mapping دو طرفه و یا اصطلاحاً two-way mapping می باشد که به آن bidirectional mapping نیز میگوییم. تمامی نگاشت هایی که تا به اینجای کار بررسی کردهایم یک طرفه بودند. به عبارت دیگر همواره یک source object و destination object داشته ایم و property ها و مقادیری را از درون source object خوانده و به درون destination object منتقل میکنیم. این نگاشت و یا mapping میتوانند در هر دو جهت پیاده سازی شوند. برای درک هرچه بهتر reverse mapping شبیه به آنچه که در تصویر زیر مشاهده می کنید از سه کلاس استفاده خواهیم کرد.
public class Order {
public int OrderNo {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public Customer Customer {
get;
set;
}
}
public class Customer {
public int CustomerID {
get;
set;
}
public string FullName {
get;
set;
}
public string Postcode {
get;
set;
}
public string ContactNo {
get;
set;
}
}
public class OrderDTO {
public int OrderId {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public int CustomerId {
get;
set;
}
public string Name {
get;
set;
}
public string Postcode {
get;
set;
}
public string MobileNo {
get;
set;
}
}
}
برای پیادهسازی reverse mapping ما میبایست از متد ReverseMap استفاده کنیم. کدی که در قسمت زیر مشاهده می کنید نحوه انجام دادن این کار را به شما نشان می دهد.
class Program {
static void Main(string[] args) {
//Step1: Initialize the Mapper
InitializeAutomapper();
//Step2: Create the Order Request
var OrderRequest = CreateOrderRequest();
//Step3: Map the OrderRequest object to Order DTO
var orderDTOData = Mapper.Map < Order,
OrderDTO > (OrderRequest);
//Step4: Print the OrderDTO Data
Console.WriteLine("After Mapping - OrderDTO Data");
Console.WriteLine("OrderId : " + orderDTOData.OrderId);
Console.WriteLine("NumberOfItems : " + orderDTOData.NumberOfItems);
Console.WriteLine("TotalAmount : " + orderDTOData.TotalAmount);
Console.WriteLine("CustomerId : " + orderDTOData.CustomerId);
Console.WriteLine("Name : " + orderDTOData.Name);
Console.WriteLine("Postcode : " + orderDTOData.Postcode);
Console.WriteLine("MobileNo : " + orderDTOData.MobileNo);
Console.WriteLine();
//Step5: modify the OrderDTO data
orderDTOData.OrderId = 10;
orderDTOData.NumberOfItems = 20;
orderDTOData.TotalAmount = 2000;
orderDTOData.CustomerId = 5;
orderDTOData.Name = "Smith";
orderDTOData.Postcode = "12345";
//Step6: Reverse Map
Mapper.Map(orderDTOData, OrderRequest);
//Step7: Print the Order Data
Console.WriteLine("After Reverse Mapping - Order Data");
Console.WriteLine("OrderNo : " + OrderRequest.OrderNo);
Console.WriteLine("NumberOfItems : " + OrderRequest.NumberOfItems);
Console.WriteLine("TotalAmount : " + OrderRequest.TotalAmount);
Console.WriteLine("CustomerId : " + OrderRequest.Customer.CustomerID);
Console.WriteLine("FullName : " + OrderRequest.Customer.FullName);
Console.WriteLine("Postcode : " + OrderRequest.Customer.Postcode);
Console.WriteLine("ContactNo : " + OrderRequest.Customer.ContactNo);
Console.ReadLine();
}
static void InitializeAutomapper() {
Mapper.Initialize(config => {
config.CreateMap < Order, OrderDTO > ()
//OrderId is different so map them using For Member
.ForMember(dest => dest.OrderId, act => act.MapFrom(src => src.OrderNo))
//Customer is a Complex type, so Map Customer to Simple type using For Membee
.ForMember(dest => dest.Name, act => act.MapFrom(src => src.Customer.FullName))
.ForMember(dest => dest.Postcode, act => act.MapFrom(src => src.Customer.Postcode))
.ForMember(dest => dest.MobileNo, act => act.MapFrom(src => src.Customer.ContactNo))
.ForMember(dest => dest.CustomerId, act => act.MapFrom(src => src.Customer.CustomerID))
.ReverseMap();
});
}
private static Order CreateOrderRequest() {
return new Order {
OrderNo = 101,
NumberOfItems = 3,
TotalAmount = 1000,
Customer = new Customer() {
CustomerID = 777,
FullName = "James Smith",
Postcode = "755019",
ContactNo = "1234567890"
},
};
}
}
با اجرا شدن برنامه خروجی را دریافت خواهد کرد.
حال فرض کنید که میخواهیم کمی در کلاس های موجود در این مثال تغییر ایجاد کنیم. لطفاً قسمت زیر را ببینید.
public class Order {
public int OrderNo {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public int CustomerId {
get;
set;
}
public string Name {
get;
set;
}
public string Postcode {
get;
set;
}
public string MobileNo {
get;
set;
}
}
public class Customer {
public int CustomerID {
get;
set;
}
public string FullName {
get;
set;
}
public string Postcode {
get;
set;
}
public string ContactNo {
get;
set;
}
}
public class OrderDTO {
public int OrderId {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public Customer customer {
get;
set;
}
}
همانطور که در قسمت بالا مشاهده می کنید حال یک property از نوع complex type در کلاس OrderDTO تعریف شده است و علاوه بر این property هایی از نوع primitive type در کلاس Order وجود دارد. حال میخواهیم با استفاده از متد ReverseMap مربوط به AutoMapper این نگاشت را به صورت معکوس پیاده سازی کنیم و بررسی کنیم که آیا امکان دریافت نتایج صحیح وجود دارند و یا خیر. کدی که در قسمت زیر مشاهده می کنید نحوه انجام دادن این کار را نشان میدهند.
class Program {
static void Main(string[] args) {
//Step1: Initialize the Mapper
InitializeAutomapper();
//Step2: Create the Order Request
var OrderRequest = CreateOrderRequest();
//Step3: Map the OrderRequest object to Order DTO
var orderDTOData = Mapper.Map < Order,
OrderDTO > (OrderRequest);
//Step4: Print the OrderDTO Data
Console.WriteLine("After Mapping - OrderDTO Data");
Console.WriteLine("OrderId : " + orderDTOData.OrderId);
Console.WriteLine("NumberOfItems : " + orderDTOData.NumberOfItems);
Console.WriteLine("TotalAmount : " + orderDTOData.TotalAmount);
Console.WriteLine("CustomerId : " + orderDTOData.customer.CustomerID);
Console.WriteLine("FullName : " + orderDTOData.customer.FullName);
Console.WriteLine("Postcode : " + orderDTOData.customer.Postcode);
Console.WriteLine("ContactNo : " + orderDTOData.customer.ContactNo);
Console.WriteLine();
//Step5: modify the OrderDTO data
orderDTOData.OrderId = 10;
orderDTOData.NumberOfItems = 20;
orderDTOData.TotalAmount = 2000;
orderDTOData.customer.CustomerID = 5;
orderDTOData.customer.FullName = "James Smith";
orderDTOData.customer.Postcode = "12345";
//Step6: Reverse Map
Mapper.Map(orderDTOData, OrderRequest);
//Step7: Print the Order Data
Console.WriteLine("After Reverse Mapping - Order Data");
Console.WriteLine("OrderNo : " + OrderRequest.OrderNo);
Console.WriteLine("NumberOfItems : " + OrderRequest.NumberOfItems);
Console.WriteLine("TotalAmount : " + OrderRequest.TotalAmount);
Console.WriteLine("CustomerId : " + OrderRequest.CustomerId);
Console.WriteLine("Name : " + OrderRequest.Name);
Console.WriteLine("Postcode : " + OrderRequest.Postcode);
Console.WriteLine("MobileNo : " + OrderRequest.MobileNo);
Console.ReadLine();
}
static void InitializeAutomapper() {
Mapper.Initialize(config => {
config.CreateMap < Order, OrderDTO > ()
.ForMember(dest => dest.OrderId, act => act.MapFrom(src => src.OrderNo))
.ForMember(dest => dest.customer, act => act.MapFrom(src => new Customer() {
CustomerID = src.CustomerId,
FullName = src.Name,
Postcode = src.Postcode,
ContactNo = src.MobileNo
}))
.ReverseMap();
});
}
private static Order CreateOrderRequest() {
return new Order {
OrderNo = 101,
NumberOfItems = 3,
TotalAmount = 1000,
CustomerId = 777,
Name = "James Smith",
Postcode = "755019",
MobileNo = "1234567890"
};
}
}
با اجرا کردن برنامه خروجی به ما نشان داده می شود.
همان طور که در تصویر بالا مشاهده می کنید مکانیزم reverse mapping مربوط به AutoMapper دقیقاً شبیه به آنچه که مورد انتظار ما بود عمل کرد و توانست primitive type ها را به درستی نگاشت کند؛ اما متاسفانه نتوانسته ایم property هایی که از نوع complex type هستند را به درستی نگاشت کنیم.
نتیجه گیری که میتوان در این قسمت داشت این است که مکانیزم reverse mapping و متد ReverseMap زمانی که property های موجود در دو کلاس، هم نام هستند به درستی عمل میکند؛ اما اگر نام property ها تغییر کند این Mapping دو طرفه متاسفانه شبیه به قبل عمل نمی کند. برای حل و فصل کردن این مشکل باید از متد ForMember استفاده کنیم. ضمناً کدی که در قسمت زیر مشاهده می کنید نحوه استفاده کردن از همین موضوع برای حل و فصل کردن مشکل موجود را نشان میدهد.
class Program {
static void Main(string[] args) {
//Step1: Initialize the Mapper
InitializeAutomapper();
//Step2: Create the Order Request
var OrderRequest = CreateOrderRequest();
//Step3: Map the OrderRequest object to Order DTO
var orderDTOData = Mapper.Map < Order,
OrderDTO > (OrderRequest);
//Step4: Print the OrderDTO Data
Console.WriteLine("After Mapping - OrderDTO Data");
Console.WriteLine("OrderId : " + orderDTOData.OrderId);
Console.WriteLine("NumberOfItems : " + orderDTOData.NumberOfItems);
Console.WriteLine("TotalAmount : " + orderDTOData.TotalAmount);
Console.WriteLine("CustomerId : " + orderDTOData.customer.CustomerID);
Console.WriteLine("FullName : " + orderDTOData.customer.FullName);
Console.WriteLine("Postcode : " + orderDTOData.customer.Postcode);
Console.WriteLine("ContactNo : " + orderDTOData.customer.ContactNo);
Console.WriteLine();
//Step5: modify the OrderDTO data
orderDTOData.OrderId = 10;
orderDTOData.NumberOfItems = 20;
orderDTOData.TotalAmount = 2000;
orderDTOData.customer.CustomerID = 5;
orderDTOData.customer.FullName = "James Smith";
orderDTOData.customer.Postcode = "12345";
//Step6: Reverse Map
Mapper.Map(orderDTOData, OrderRequest);
//Step7: Print the Order Data
Console.WriteLine("After Reverse Mapping - Order Data");
Console.WriteLine("OrderNo : " + OrderRequest.OrderNo);
Console.WriteLine("NumberOfItems : " + OrderRequest.NumberOfItems);
Console.WriteLine("TotalAmount : " + OrderRequest.TotalAmount);
Console.WriteLine("CustomerId : " + OrderRequest.CustomerId);
Console.WriteLine("Name : " + OrderRequest.Name);
Console.WriteLine("Postcode : " + OrderRequest.Postcode);
Console.WriteLine("MobileNo : " + OrderRequest.MobileNo);
Console.ReadLine();
}
static void InitializeAutomapper() {
Mapper.Initialize(config => {
config.CreateMap < Order, OrderDTO > ()
.ForMember(dest => dest.OrderId, act => act.MapFrom(src => src.OrderNo))
.ForMember(dest => dest.customer, act => act.MapFrom(src => new Customer() {
CustomerID = src.CustomerId,
FullName = src.Name,
Postcode = src.Postcode,
ContactNo = src.MobileNo
}))
.ReverseMap()
.ForMember(dest => dest.CustomerId, act => act.MapFrom(src => src.customer.CustomerID))
.ForMember(dest => dest.Name, act => act.MapFrom(src => src.customer.FullName))
.ForMember(dest => dest.MobileNo, act => act.MapFrom(src => src.customer.ContactNo))
.ForMember(dest => dest.Postcode, act => act.MapFrom(src => src.customer.Postcode));
});
}
private static Order CreateOrderRequest() {
return new Order {
OrderNo = 101,
NumberOfItems = 3,
TotalAmount = 1000,
CustomerId = 777,
Name = "James Smith",
Postcode = "755019",
MobileNo = "1234567890"
};
}
}
public class Order {
public int OrderNo {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public int CustomerId {
get;
set;
}
public string Name {
get;
set;
}
public string Postcode {
get;
set;
}
public string MobileNo {
get;
set;
}
}
public class Customer {
public int CustomerID {
get;
set;
}
public string FullName {
get;
set;
}
public string Postcode {
get;
set;
}
public string ContactNo {
get;
set;
}
}
public class OrderDTO {
public int OrderId {
get;
set;
}
public int NumberOfItems {
get;
set;
}
public int TotalAmount {
get;
set;
}
public Customer customer {
get;
set;
}
}
حال می توانید برنامه را اجرا کنید. در قسمت بعدی از این آموزش در رابطه با نگاشت شرطی و یا conditional mapping در AutoMapper صحبت خواهم کرد.