‫Facet؛ یک source generator جایگزین AutoMapper

مقدمه

مفهوم فست (Facet) و نحوه عملکرد آن

ویژگی‌های کلیدی فست (Facet)

public class Person
{
    public string Name { get; set; }
    public string Email { get; set; }
    public int Age { get; set; }
}

[Facet(typeof(Person), exclude: nameof(Person.Email))]
public partial class PersonDto;

[Facet(typeof(Person), Kind = FacetKind.Record)]
public partial record PersonRecord;

public class UserMapConfig : IFacetMapConfiguration<User, UserDto>
{
    public static void Map(User source, UserDto target)
    {
        target.FullName = $"{source.FirstName} {source.LastName}";
    }
}

[Facet(typeof(User), Configuration = typeof(UserMapConfig))]
public partial class UserDto;

using Facet.Extensions;

var person = new Person { Name = "Alice", Email = "alice@example.com", Age = 30 };
var dto = person.ToFacet<Person, PersonDto>(); // نگاشت یک شیء

var dtos = dbContext.People
    .SelectFacet<Person, PersonDto>() // طرح‌ریزی IQueryable
    .ToListAsync();

مزایای استفاده از فست (Facet)

• کاهش کد بویلرپلیت: فست با تولید خودکار DTOها و منطق نگاشت، نیاز به نوشتن کد تکراری را به میزان قابل توجهی کاهش می‌دهد.
• بهبود عملکرد: از آنجایی که تمام منطق نگاشت در زمان کامپایل تولید می‌شود، هیچ سربار عملکردی در زمان اجرا وجود ندارد. این امر به ویژه در برنامه‌های با حجم بالای داده و عملیات نگاشت مکرر حائز اهمیت است.
• افزایش ایمنی نوع: فست از تایپ قوی #C بهره می‌برد و از بروز خطاهای مربوط به نگاشت در زمان اجرا جلوگیری می‌کند. همچنین، از ویژگی‌های آگاهی از تهی‌پذیری #C برای اطمینان از مدیریت صحیح مقادیر تهی (null) استفاده می‌کند.
• رعایت اصل DRY (Don't Repeat Yourself): با تعریف نگاشت‌ها در یک مکان و تولید خودکار کد مربوطه، فست به حفظ اصل عدم تکرار در کد کمک می‌کند.
• شروع سریع: نصب و استفاده از فست بسیار آسان است و به سرعت می‌توان از مزایای آن در پروژه‌ها بهره‌مند شد.

نتیجه‌گیری