‫بازنگری در استفاده از MediatR در توسعه برنامه‌های ASP.NET Core

• جداسازی APIها از منطق کسب و کار (Decouple APIs from business logic)
• بهبود قابلیت تست‌پذیری (Improve testability)
• فعال‌سازی منطق‌های برش عرضی (Cross-cutting logic) قابل استفاده مجدد از طریق رفتارهای خط لوله (Pipeline Behaviors)

[HttpPost("/orders")]
public async Task<IActionResult> CreateOrder(CreateOrderCommand command, IMediator mediator)
{
    var result = await mediator.Send(command);
    return result.Match(
        onSuccess: orderId => CreatedAtAction(nameof(GetOrder), new { id = orderId }, orderId),
        onFailure: errors => Problem(errors)
    );
}

public record CreateOrderCommand(Guid CustomerId, List<OrderItem> Items) : IRequest<Result<Guid>>;

public record OrderItem(Guid ProductId, int Quantity, decimal Price);

public class CreateOrderCommandHandler : IRequestHandler<CreateOrderCommand, Result<Guid>>
{
    private readonly ApplicationDbContext _dbContext;

    public CreateOrderCommandHandler(ApplicationDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    public async Task<Result<Guid>> Handle(CreateOrderCommand request, CancellationToken cancellationToken)
    {
        var order = new Order
        {
            CustomerId = request.CustomerId,
            Items = request.Items.Select(i => new OrderItem
            {
                ProductId = i.ProductId,
                Quantity = i.Quantity,
                Price = i.Price
            }).ToList()
        };

        _dbContext.Orders.Add(order);
        await _dbContext.SaveChangesAsync(cancellationToken);

        return Result.Success(order.Id);
    }
}

• یک شیء فرمان (Command object) با نام CreateOrderCommand
• یک شیء نتیجه (Result object) با نام Result<Guid>
• یک کلاس هندلر (Handler class) با نام CreateOrderCommandHandler که رابط IRequestHandler را پیاده‌سازی می‌کند.
• یک مرحله ثبت میانجی (Mediator registration step) برای اتصال فرمان و هندلر.
• یک Endpoint که وظیفه‌ای جز انتقال درخواست به هندلر ندارد.

public class CreateOrderEndpoint : IEndpoint
{
    public void MapEndpoint(IEndpointRouteBuilder endpoints)
    {
        endpoints.MapPost("/orders", async (CreateOrderRequest request, ApplicationDbContext dbContext) =>
        {
            var order = new Order
            {
                CustomerId = request.CustomerId,
                Items = request.Items.Select(i => new OrderItem
                {
                    ProductId = i.ProductId,
                    Quantity = i.Quantity,
                    Price = i.Price
                }).ToList()
            };

            dbContext.Orders.Add(order);
            await dbContext.SaveChangesAsync();

            return Results.Created($"/orders/{order.Id}", order.Id);
        });
    }
}

public record CreateOrderRequest(Guid CustomerId, List<OrderItemRequest> Items);
public record OrderItemRequest(Guid ProductId, int Quantity, decimal Price);

app.AddEndpoint<CreateOrderEndpoint>();

• نیازی به میانجی (Mediator) نیست.
• نیازی به هندلر (Handler) جداگانه نیست.
• نیازی به فایل‌های اضافی فقط برای انتقال داده به پایگاه داده نیست.

public record CreateOrderRequest(Guid CustomerId, [NotEmpty] List<OrderItemRequest> Items);
public record OrderItemRequest(Guid ProductId, [Range(1, 100)] int Quantity, decimal Price);

• تعداد فایل‌های کمتر
• ساختار تمیزتر
• تجربه توسعه روان‌تر