NsMediatoR 1.0.0

NsMediatoR

Uma implementação simples e leve do padrão Mediator para .NET, similar ao MediatR.

📋 Sobre

NsMediatoR é uma biblioteca que implementa o padrão Mediator, facilitando a comunicação entre componentes da sua aplicação de forma desacoplada. Permite o envio de requests/responses e publicação de notifications.

✨ Características

• 🚀 Simples e leve
• 📦 Compatível com .NET Standard 2.1
• 🔧 Integração com Microsoft.Extensions.DependencyInjection
• 📨 Suporte a Requests/Responses
• 📢 Suporte a Notifications
• ⚡ Operações assíncronas com CancellationToken

📦 Instalação

dotnet add package NsMediatoR

🚀 Como Usar

1. Configuração no Startup/Program.cs

using NsMediatoR.Extensions;

// Configure os serviços
services.AddNsMediatoR(typeof(Program).Assembly);

2. Criando um Request/Response

using NsMediatoR.Interfaces;

// Request
public class GetUserQuery : IRequest<UserDto>
{
    public int Id { get; set; }
}

// Response
public class UserDto
{
    public int Id { get; set; }
    public string Name { get; set; }
}

// Handler
public class GetUserHandler : IRequestHandler<GetUserQuery, UserDto>
{
    public async Task<UserDto> Handle(GetUserQuery request, CancellationToken cancellationToken)
    {
        // Lógica para buscar o usuário
        return new UserDto { Id = request.Id, Name = "João" };
    }
}

3. Criando uma Notification

using NsMediatoR.Interfaces;

// Notification
public class UserCreatedNotification : INotification
{
    public int UserId { get; set; }
    public string UserName { get; set; }
}

// Handler
public class UserCreatedHandler : INotificationHandler<UserCreatedNotification>
{
    public async Task Handle(UserCreatedNotification notification, CancellationToken cancellationToken)
    {
        // Lógica para processar a notificação
        Console.WriteLine($"Usuário {notification.UserName} foi criado!");
    }
}

4. Usando o Mediator

public class UserController
{
    private readonly IMediator _mediator;

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

    public async Task<UserDto> GetUser(int id)
    {
        var query = new GetUserQuery { Id = id };
        return await _mediator.Send(query);
    }

    public async Task CreateUser(string name)
    {
        // ... lógica de criação ...
        
        var notification = new UserCreatedNotification 
        { 
            UserId = 1, 
            UserName = name 
        };
        await _mediator.Publish(notification);
    }
}

📚 Interfaces Disponíveis

• IMediator - Interface principal para envio de requests e publicação de notifications
• IRequest<TResponse> - Interface para requests que retornam uma response
• IRequestHandler<TRequest, TResponse> - Interface para handlers de requests
• INotification - Interface para notifications
• INotificationHandler<TNotification> - Interface para handlers de notifications

🛠️ Requisitos

• .NET Standard 2.1+
• Microsoft.Extensions.DependencyInjection 8.0.1+

👨‍💻 Autor

Vinicius Ramos

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

⭐ Se este projeto foi útil para você, considere dar uma estrela!