MediatorX 1.0.2.1

MediatorX

MediatorX es una biblioteca liviana para .NET que implementa el patrón CQRS (Command Query Responsibility Segregation), actuando como una alternativa simple, sin dependencias externas, a MediatR.

Está diseñada para desarrolladores que buscan una solución minimalista pero poderosa para enviar comandos y consultas dentro de proyectos con arquitectura limpia (Clean Architecture).

🚀 Características

• ✔️ Alternativa ligera a MediatR
• 🔌 Sin dependencias externas
• 📦 Fácil de integrar en proyectos existentes
• ⚙️ Compatible con .NET 6, 7, 8, 9
• 🧪 Fácil de testear y mantener
• 🧱 Ideal para Clean Architecture y CQRS

📦 Instalación

Instala MediatorX desde NuGet:

dotnet add package MediatorX

🧱 Ejemplo de uso

1. Definir un Command

using MediatorX.Interfaces;

public class CrearUsuarioCommand : IRequest<string>
{
    public string Nombre { get; set; } = string.Empty;
    public string Email { get; set; } = string.Empty;
}

2. Crear el Handler del Command

using MediatorX.Interfaces;

public class CrearUsuarioHandler : IRequestHandler<CrearUsuarioCommand, string>
{
    public Task<string> Handle(CrearUsuarioCommand request, CancellationToken cancellationToken = default)
    {
        return Task.FromResult($"Usuario '{request.Nombre}' creado exitosamente.");
    }
}

3. Usar el Dispatcher en un controlador

using MediatorX.Interfaces;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class UsuariosController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsuariosController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost("crear")]
    public async Task<IActionResult> CrearUsuario([FromBody] CrearUsuarioCommand command)
    {
        var resultado = await _mediator.Send(command);
        return Ok(new { mensaje = resultado });
    }
}

4. Definir una Query

using MediatorX.Interfaces;

public class ObtenerUsuarioQuery : IRequest<UsuarioDto>
{
    public int Id { get; set; }
}

6. Usar la Query en un controlador

[HttpGet("{id}")]
public async Task<IActionResult> ObtenerUsuario(int id)
{
    var query = new ObtenerUsuarioQuery { Id = id };
    var usuario = await _mediator.Send(query);
    return Ok(usuario);
}

⚙️ Configuración en Program.cs

using MediatorX;
using MediatorX.Interfaces;
using MediatorX.DependencyInjection;

builder.Services.AddScoped<IMediator, Mediator>();
builder.Services.AddScoped<IPublisher, Mediator>();

// Registra automáticamente todos los handlers del ensamblado donde están definidos
builder.Services.AddMediatorX(typeof(CrearUsuarioCommand).Assembly);

✅ Ventajas

• 🔌 Sin dependencias externas
• 🧠 Pensado para arquitectura limpia
• ⚡ Registro automático de handlers
• 🔁 Compatible con CQRS
• 🧪 Fácil de testear

📄 Requisitos

• .NET 6.0 o superior
• Compatible con .NET 6, 7, 8, 9
• Requiere Microsoft.Extensions.DependencyInjection (incluido en ASP.NET Core)

📘 Licencia

• MIT © 2025 Ramon Castillo