Product DTO using Auto Mapper

شوف الـ Output بتاعك

• لو لقيت فيه Nested، اسأل نفسك: هل محتاجه ولا لأ؟
• غالبًا مش هنحتاج نظهر الـ Id مرتين أو أكتر، زي في حالة الـ Brand أو الـ Category.
• يعني بدل ما نظهر الـ Id مع الاسم، ممكن نظهر الاسم بس عشان نسهل الشغل على الـ Front-end developer.
• دايمًا خليك في الـ Output Flat لو مفيش داعي للـ Nesting.

---

View Model vs Model

• الفكرة هنا إن المشاكل اللي عندنا في الـ Back ما تخصش الـ Front-end.
• عشان كده بنبعت View Model بدل ما نبعت الـ Model نفسه.
• في نظام الـ MVC:
  • بنعمل Map من الـ Model لـ View Model في الـ Get.
  • ومن الـ View Model لـ Model في الـ Create, Update, و Delete.

---

الفرق بين View Model و DTO

• في الـ API مفيش حاجة اسمها View Model، لكن فيه حاجة اسمها DTO (Data Transfer Object).
• الـ DTO بتكون الوسيط بين الـ Back والـ Front:
  • الـGet: من الـ Back للـ Front.
  • الـCreate, Update, Delete: من الـ Front للـ Back.

---

خطوات إنشاء الـ DTO

1. إضافة فولدر Dtos:
   • في الـ API نعمل فولدر اسمه Dtos.
   • نعمل كلاس اسمه ProductToReturnDto.
2. إعداد الـ ProductToReturnDto:
   • ناخد الحاجات اللي محتاجينها من الـ Product ونحطها في الكلاس.
   • الكلاس مش هيورث من الـ BaseEntity.
   • نضيف الـ Properties بالشكل التالي:

public class ProductToReturnDto
{
	public int Id { get; set; }
	public string? Name { get; set; }
	public string? Description { get; set; }
	public decimal Price { get; set; }
	public string PictureUrl { get; set; }
	public string Brand { get; set; }
	public int BrandId { get; set; }
	public string Category { get; set; }
	public int CategoryId { get; set; }
}

3. إضافة AutoMapper:
   • نعمل Install للـ AutoMapper في مشروع الـ API.
   • نحطها في الـ Services:

builder.Services.AddAutoMapper(typeof(MappingProfiles));

AutoMapper.Extensions.Microsoft.DependencyInjection

---

إعداد Mapping Profiles

1. إنشاء كلاس MappingProfiles:
   • نروح في فولدر الـ Dtos ونعمل فولدر جديد اسمه Helpers.
   • نعمل كلاس اسمه MappingProfiles ويورث من كلاس Profile.
2. إعداد الماب:
   • في الكلاس نعمل Map بين الـ Product والـ ProductToReturnDto:

public class MappingProfiles : Profile
{
	public MappingProfiles()
	{
		CreateMap<Product, ProductToReturnDto>()
			.ForMember(d => d.Brand, O => O.MapFrom(s => s.Brand.Name))
			.ForMember(d => d.Category, O => O.MapFrom(s => s.Category.Name));
	}
}

• من الـ Destination روح اعمل Map من الـ Source واحدد ايه بالظبط

---

تعديل الـ Controller

1. إضافة IMapper:
   • نعدل الـ Constructor بتاع الـ Controller عشان يقبل الـ IMapper:

private readonly IGenericRepository<Product> _productsRepo;
private readonly IMapper _mapper;
 
public ProductsController(IGenericRepository<Product> productsRepo, IMapper mapper)
{
	_productsRepo = productsRepo;
	_mapper = mapper;
}

1. GetProduct:
   • إضافة ميثود للـ Get عشان ترجّع الـ DTO:

[HttpGet("{id}")]
public async Task<ActionResult<ProductToReturnDto>> GetProduct(int id)
{
	var product = await _productsRepo.GetAsync(id);
	if (product == null)
		return NotFound(new { message = "Not Found", statusCode = 404 });
 
	return Ok(_mapper.Map<Product, ProductToReturnDto>(product));
}

2. GetProducts:
   • ميثود ترجّع كل المنتجات بـ DTO:

[HttpGet]
public async Task<ActionResult<IEnumerable<ProductToReturnDto>>> GetProducts()
{
	var products = await _productsRepo.GetAllWithSpecAsync(new ProductWithBrandAndCategorySpecifications());
	if (products == null || !products.Any())
		return NotFound("No Products available");
 
	return Ok(_mapper.Map<IEnumerable<Product>, IEnumerable<ProductToReturnDto>>(products));
}

---