در قسمت های قبلی از این سری آموزشی در رابطه با AutoMapper و مکانیزم های مختلف آن صحبت کردهایم. در این قسمت از این سری آموزشی در رابطه با نگاشت شرطی و یا conditional mapping در AutoMapper صحبت خواهیم کرد. همان طور که تا به اینجای کار مشاهده کردید AutoMapper به راحتی می تواند کار نگاشت مربوط به property ها را برای ما انجام بدهد.
با مکانیزم conditional mapping میتوانیم شرطهایی را برای property های موجود در source object لحاظ کنیم که اگر آن شرطها برقرار بودند آن property ها در نگاشت شرکت داده شود. برای مثال فرض کنید که میخواهیم یک property را فقط زمانی در نگاشت شرکت بدهیم که مقدار موجود در آن از صفر بزرگتر باشد. در چنین شرایطی میتوانیم از مکانیزم نگاشت شرطی و یا conditional mapping استفاده کنیم.
در ابتدا نیز خدمتتان عرض میکنیم که حتماً قسمت های قبلی از این سری آموزشی را مطالعه کنید تا بتوانید به بهترین شکل مطالب مربوط به این قسمت را فرا بگیرید. حال برای درک هرچه بهتر نگاشت شرطی شبیه به آنچه که در تصویر زیر مشاهده می کنید از دو کلاس استفاده خواهیم کرد.
public class Product
{
public int ProductID { get; set; }
public string Name { get; set; }
public string OptionalName { get; set; }
public int Quantity { get; set; }
public int Amount { get; set; }
}
public class ProductDTO
{
public int ProductID { get; set; }
public string ItemName { get; set; }
public int ItemQuantity { get; set; }
public int Amount { get; set; }
}
نیازمندی هایی که برای ما در این پروژه تعریف میشوند شبیه به قسمت زیر خواهند بود.
برای به دست آوردن این رفتار در AutoMapper می بایست از نگاشت شرطی و یا conditional mapping استفاده کنیم. در ابتدا می بایست شبیه به آنچه که در کد زیر مشاهده می کنید پیکربندی خاصی را انجام بدهیم.
Mapper.Initialize(config =>
{
config.CreateMap<Product, ProductDTO>()
//If the Name Start with A then Map the Name Value else Map the OptionalName value
.ForMember(dest => dest.ItemName, act => act.MapFrom(src =>
(src.Name.StartsWith("A") ? src.Name : src.OptionalName)))
//Take the quantity value if its greater than 0
.ForMember(dest => dest.ItemQuantity, act => act.Condition(src => (src.Quantity > 0)))
//Take the amount value if its greater than 100
.ForMember(dest => dest.Amount, act => act.Condition(src => (src.Amount > 100)));
});
قسمت Condition در AutoMapper برای اضافه کردن شرط به property هایی که قرار است در نگاشت شرکت داده شوند استفاده می شود. علاوه بر این قسمت MapFrom برای انجام نگاشت های سفارشی از property های درون source object و destination object استفاده میشود. کدی که در قسمت زیر مشاهده می کنید نیز دقیقاً این موضوع را نشان میدهد.
using AutoMapper;
namespace AutoMapperDemo
{
class Program
{
static void Main(string[] args)
{
InitializeAutomapper();
Product product = new Product()
{
ProductID = 101,
Name = "Led TV",
OptionalName = "Product name not start with A",
Quantity = -5,
Amount = 1000
};
var productDTO = Mapper.Map<Product, ProductDTO>(product);
Console.WriteLine("After Mapping : Product");
Console.WriteLine("ProductID : " + product.ProductID);
Console.WriteLine("Name : " + product.Name);
Console.WriteLine("OptionalName : " + product.OptionalName);
Console.WriteLine("Quantity : " + product.Quantity);
Console.WriteLine("Amount : " + product.Amount);
Console.WriteLine();
Console.WriteLine("After Mapping : ProductDTO");
Console.WriteLine("ProductID : " + productDTO.ProductID);
Console.WriteLine("ItemName : " + productDTO.ItemName);
Console.WriteLine("ItemQuantity : " + productDTO.ItemQuantity);
Console.WriteLine("Amount : " + productDTO.Amount);
Console.ReadLine();
}
static void InitializeAutomapper()
{
Mapper.Initialize(config =>
{
config.CreateMap<Product, ProductDTO>()
//If the Name Start with A then Map the Name Value else Map the OptionalName value
.ForMember(dest => dest.ItemName, act => act.MapFrom(src =>
(src.Name.StartsWith("A") ? src.Name : src.OptionalName)))
//Take the quantity value if its greater than 0
.ForMember(dest => dest.ItemQuantity, act => act.Condition(src => (src.Quantity > 0)))
//Take the amount value if its greater than 100
.ForMember(dest => dest.Amount, act => act.Condition(src => (src.Amount > 100)));
});
}
}
public class Product
{
public int ProductID { get; set; }
public string Name { get; set; }
public string OptionalName { get; set; }
public int Quantity { get; set; }
public int Amount { get; set; }
}
public class ProductDTO
{
public int ProductID { get; set; }
public string ItemName { get; set; }
public int ItemQuantity { get; set; }
public int Amount { get; set; }
}
}
با اجرا کردن برنامه خروجی را مشاهده خواهید کرد. تا به اینجای کار این مقاله را به پایان می رسانیم و در قسمت بعدی در رابطه با نحوه استفاده کردن از AutoMapper برای عدم شرکت دادن یک property در مکانیزم نگاشت صحبت خواهم کرد. تا به اینجای کار دیدیم که با استفاده از AutoMapper و نگاشت شرطی می توانیم فقط در شرایط خاصی property هایی را در مکانیزم نگاشت شرکت بدهیم.
منبع: "وبسایت پرووید "