FluentHandlers 0.0.0-alpha.0.4

FluentHandlers

FluentHandlers is a lightweight .NET library designed to simplify and streamline the handling of queries and commands in .NET applications. It leverages FluentValidation for input validation, offering an efficient and intuitive approach to handling business logic.

Features

• Fluent Validation Integration: Seamlessly integrates with FluentValidation for input validation of queries and commands.
• Easy-to-Use: Simple and intuitive interfaces for handling various operations.
• Flexible: Supports both parameterized and parameterless handlers.
• Dependency Injection Support: Easy registration of handlers with built-in extension methods for .NET's dependency injection system.

Getting Started

To use FluentHandlers in your project, first install the package via NuGet:

dotnet add package FluentHandlers

Usage

Registering Handlers

In your .NET application, register your handlers using the provided extension method:

using FluentHandlers;
using Microsoft.Extensions.DependencyInjection;

public void ConfigureServices(IServiceCollection services)
{
    // Other service configurations...

    // Add FluentHandlers
    services.AddFluentHandlers(new[] { Assembly.GetExecutingAssembly() });
}

Implementing a QueryHandler

public class GetUserByIdQuery
{
    public string UserId { get; set; }
}

public class GetUserByIdQueryHandler : QueryHandler<GetUserByIdQuery, UserDto>
{
    protected override void DefineRules()
    {
        RuleFor(query => query.UserId).NotEmpty();
    }

    protected override async Task<UserDto> HandleValidatedQuery(GetUserByIdQuery query)
    {
        // Logic to fetch user data
        return new UserDto { /* ... */ };
    }
}

Implementing a CommandHandler

public class UpdateUserCommand
{
    public string UserId { get; set; }
    public string Name { get; set; }
}

public class UpdateUserCommandHandler : CommandHandler<UpdateUserCommand, bool>
{
    protected override void DefineRules()
    {
        RuleFor(command => command.UserId).NotEmpty();
        RuleFor(command => command.Name).NotEmpty();
    }

    protected override async Task<bool> HandleValidatedCommand(UpdateUserCommand command)
    {
        // Logic to update user
        return true;
    }
}

License

This project is licensed under the MIT License.