YolalMediatR 1.0.1

YolalMediatR

A simple MediatR implementation for .NET that provides a mediator pattern for decoupling request/response handling.

Features

• 🚀 Simple and lightweight mediator implementation
• 🔌 Built-in dependency injection support
• 📦 Supports .NET 6.0, 7.0, 8.0, and 9.0
• ⚡ Fast handler resolution with caching
• 🎯 Type-safe request/response handling

Installation

Install the package via NuGet:

dotnet add package YolalMediatR

Or via Package Manager:

Install-Package YolalMediatR

Quick Start

1. Register Services

In your Program.cs or Startup.cs, register the mediator and handlers:

using YolalMediatR;
using System.Reflection;

var builder = WebApplication.CreateBuilder(args);

// Register mediator and all handlers from the current assembly
builder.Services.AddMediator(Assembly.GetExecutingAssembly());

var app = builder.Build();

2. Create a Request

Define your request class:

using YolalMediatR;

public class GetUserRequest : IRequest<UserResponse>
{
    public int UserId { get; set; }
}

public class UserResponse
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public string Email { get; set; } = string.Empty;
}

3. Create a Handler

Implement the handler for your request:

using YolalMediatR;

public class GetUserHandler : IRequestHandler<GetUserRequest, UserResponse>
{
    public async Task<UserResponse> Handle(GetUserRequest request, CancellationToken cancellationToken = default)
    {
        // Your business logic here
        return new UserResponse
        {
            Id = request.UserId,
            Name = "John Doe",
            Email = "john@example.com"
        };
    }
}

4. Use the Mediator

Inject IMediator and send requests:

using YolalMediatR;

public class UserController : ControllerBase
{
    private readonly IMediator _mediator;

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

    [HttpGet("{id}")]
    public async Task<ActionResult<UserResponse>> GetUser(int id)
    {
        var request = new GetUserRequest { UserId = id };
        var response = await _mediator.Send(request);
        return Ok(response);
    }
}

Advanced Usage

Registering Handlers from Multiple Assemblies

builder.Services.AddMediator(typeof(GetUserHandler).Assembly);
builder.Services.AddMediator(typeof(OrderHandler).Assembly);

Using Cancellation Tokens

var response = await _mediator.Send(request, cancellationToken);

Requirements

• .NET 6.0 or higher
• Microsoft.Extensions.DependencyInjection.Abstractions 8.0.0 or higher

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.