Jaber.Mediator.Abstractions 0.0.4

Jaber.Mediator.Abstractions

Implementacao simples do padrao Mediator para .NET, com suporte a DI via Microsoft.Extensions.DependencyInjection.

Indice

• Por que usar
• Pacotes
• Instalacao
• Uso rapido
• Registro via DI
• Exemplo com Minimal API
• Observacoes
• Projetos de exemplo

Por que usar

• Fluxo simples para request/handler, sem dependencias extras.
• Registro automatico de handlers via DI.
• Separacao clara entre contratos e implementacao.

Pacotes

Instalacao

Instale os contratos:

dotnet add package Jaber.Mediator.Abstractions

Uso rapido

1. Defina um request e um handler:

using Jaber.Mediator.Abstractions;

public sealed class CreateAccountRequest : IRequest<string>
{
    public string Username { get; init; } = string.Empty;
}

public sealed class CreateAccountHandler : IHandler<CreateAccountRequest, string>
{
    public Task<string> HandleAsync(CreateAccountRequest request, CancellationToken cancellationToken = default)
        => Task.FromResult($"{request.Username} created");
}

2. Registre o mediator e os handlers:

using Jaber.Mediator.Extensions;
using Jaber.Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddMediator(typeof(Program).Assembly);

3. Envie o request:

using Jaber.Mediator.Abstractions;

var provider = services.BuildServiceProvider();
var mediator = provider.GetRequiredService<IMediator>();

var result = await mediator.SendAsync(new CreateAccountRequest { Username = "batman" });
Console.WriteLine(result);

Registro via DI

AddMediator faz:

• Registra IMediator como Transient.
• Escaneia as assemblies informadas e registra todo IHandler<,>.

Se seus handlers estao em outros projetos, passe todas as assemblies necessarias:

services.AddMediator(
    typeof(Program).Assembly,
    typeof(SomeOtherHandler).Assembly
);

Exemplo com Minimal API

using Jaber.Mediator.Abstractions;
using MyMediator.Application;
using MyMediator.Application.Accounts.UseCases.Create;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplication();

var app = builder.Build();

app.MapPost("/v1/accounts", async (IMediator mediator, Request command) =>
{
    var result = await mediator.SendAsync(command);
    return result;
});

app.Run();

Observacoes

• Target framework: net10.0.
• Se nenhum handler for registrado para um request, o mediator lanca InvalidOperationException.

Projetos de exemplo

• Mediator.Samples
• MyMediator.Api