‫بازنگری در استفاده افراطی از الگوهای طراحی: نقدی بر کاربرد واسط‌گر (Mediator) در معماری‌های نوین دات‌نت

چکیده: الگوهای طراحی نرم‌افزار، راهکارهایی استاندارد و آزموده‌شده برای حل مسائل رایج در مهندسی نرم‌افزار به شمار می‌روند؛ با این حال، استفاده کورکورانه یا افراطی از آن‌ها می‌تواند به پدیده «مهندسی بیش‌ازحد» (Over-engineering) و تحمیل بدهی فنی منجر شود. در سال‌های اخیر، کاربرد کتابخانه‌های مبتنی بر الگوی واسط‌گر (Mediator Pattern) مانند MediatR در جامعه توسعه‌دهندگان دات‌نت (Microsoft .NET) چنان فراگیر شد که بدون ارزیابی نیاز واقعی، به عنوان پیش‌فرضِ جدایی‌ناپذیر معماری پیازی (Onion Architecture) یا معماری تمیز (Clean Architecture) در نظر گرفته می‌شد. این مقاله به بررسی آسیب‌های ناشی از لایه‌‌بندی‌های غیرضروری و غیرمستقیم‌سازی مفرط (Indirection) ناشی از به‌‌کارگیری این الگو پرداخته و نشان می‌دهد که چگونه قابلیت‌های نوین زبان C# و رانتایم مدرن دات‌نت—نظیر نوع‌های رکورد (Records)، نگاشت الگویی (Pattern Matching)، سرویس‌های کلیددار (Keyed Services) و تزریق وابستگی صریح—می‌توانند بدون وابستگی به کتابخانه‌های شخص ثالث، معماری‌های خواناتر، با کارایی بالاتر و نگهداری‌پذیرتر را رقم بزنند.

• تایپ‌های رکورد (Records): تعریف ساده و خطی DTOها و مدل‌های تغییرناپذیر (Immutable).
• سرویس‌های کلیددار (Keyed Services): که در نسخه‌های اخیر دات‌نت معرفی شده و امکان حل چندین پیاده‌سازی از یک رابط را بر اساس کلید بدون نیاز به ساختار Mediator ممکن ساخته‌اند.
• فیلترهای اندپوینت (Endpoint Filters): در رابط‌های برنامه‌نویسی کمینه (Minimal APIs)، رفتارهای متقاطع نظیر لاگ‌برداری، اعتبارسنجی و اندازه‌گیری زمان به‌صورت مستقیم روی لایه وب یا لایه‌های خدمات مدیریت می‌شوند.

// کنترل‌کننده یا اندپوینت
app.MapPost("/orders", async (CreateOrderCommand command, IMediator mediator) =>
{
    var orderId = await mediator.Send(command);
    return Results.Created($"/orders/{orderId}", new { Id = orderId });
});

// تعریف فرمان و پاسخ
public record CreateOrderCommand(Guid CustomerId, decimal Amount) : IRequest<Guid>;

// اداره‌کننده
public class CreateOrderHandler : IRequestHandler<CreateOrderCommand, Guid>
{
    public async Task<Guid> Handle(CreateOrderCommand request, CancellationToken ct)
    {
        // منطق ایجاد سفارش...
        return Guid.NewGuid();
    }
}

// قرارداد مستقیم و شفاف
public interface IOrderService
{
    ValueTask<Guid> CreateOrderAsync(CreateOrderRequest request, CancellationToken ct = default);
}

public record CreateOrderRequest(Guid CustomerId, decimal Amount);

// اندپوینت خوانا، صریح و بدون سربار
app.MapPost("/orders", async (CreateOrderRequest request, IOrderService orderService, CancellationToken ct) =>
{
    var orderId = await orderService.CreateOrderAsync(request, ct);
    return Results.Created($"/orders/{orderId}", new { Id = orderId });
});

• ردیابی آنی: فشردن کلید ناوبری (F12 در Visual Studio)، توسعه‌دهنده را مستقیماً به متد مورد نظر یا رابط آن می‌برد.
• کاهش حافظه موقت: استفاده از ValueTask و حذف اشیای میانی، تخصیص حافظه را به حداقل می‌رساند.
• تست‌پذیری ساده: نوشتن Mock یا Test Double برای IOrderService بدون نیاز به شبیه‌سازی کانتینرهای درونی پیچیده انجام می‌شود.

// پیاده‌سازی اصلی منطق کسب‌وکار
public class OrderService : IOrderService
{
    public ValueTask<Guid> CreateOrderAsync(CreateOrderRequest request, CancellationToken ct = default)
    {
        // اجرای عملیات تجاری
        return ValueTask.FromResult(Guid.NewGuid());
    }
}

// تزیین‌کننده جهت افزودن قابلیت لاگ‌برداری
public class LoggingOrderServiceDecorator(
    IOrderService innerService, 
    ILogger<LoggingOrderServiceDecorator> logger) : IOrderService
{
    public async ValueTask<Guid> CreateOrderAsync(CreateOrderRequest request, CancellationToken ct = default)
    {
        logger.LogInformation("شروع پردازش سفارش برای مشتری {CustomerId}", request.CustomerId);
        var result = await innerService.CreateOrderAsync(request, ct);
        logger.LogInformation("سفارش {OrderId} با موفقیت ثبت شد", result);
        return result;
    }
}

builder.Services.AddScoped<OrderService>();
builder.Services.AddScoped<IOrderService>(sp => 
    new LoggingOrderServiceDecorator(
        sp.GetRequiredService<OrderService>(),
        sp.GetRequiredService<ILogger<LoggingOrderServiceDecorator>>()
    ));