RCommon.FluentValidation 2.3.2-alpha.0.2

RCommon.FluentValidation

FluentValidation integration for RCommon's IValidationProvider abstraction. This package bridges the FluentValidation library into RCommon's validation pipeline, resolving registered IValidator<T> instances from the DI container and executing them with support for automatic CQRS command/query validation.

Features

• Implements IValidationProvider using the FluentValidation library
• Resolves and executes all registered IValidator<T> instances for a given type from DI
• Runs multiple validators concurrently via Task.WhenAll
• Maps FluentValidation failures to RCommon's ValidationOutcome and ValidationFault types
• Supports optional automatic validation of CQRS commands and queries via CqrsValidationOptions
• Assembly scanning to auto-register all validators in one or more assemblies
• Configurable throwOnFaults behavior to throw ValidationException on failure
• Registered as a scoped service in the DI container

Installation

dotnet add package RCommon.FluentValidation

Usage

Register FluentValidation through the RCommon builder and add your validators:

using RCommon;
using RCommon.FluentValidation;

services.AddRCommon(builder =>
{
    builder.WithValidation<FluentValidationBuilder>(validation =>
    {
        validation.AddValidator<CreateOrderDto, CreateOrderDtoValidator>();

        // Or scan an assembly for all validators
        validation.AddValidatorsFromAssembly(typeof(CreateOrderDtoValidator).Assembly);
    });
});

To enable automatic validation in the CQRS pipeline:

services.AddRCommon(builder =>
{
    builder.WithValidation<FluentValidationBuilder>(options =>
    {
        options.ValidateCommands = true;
        options.ValidateQueries = true;
    });
});

Inject and use IValidationProvider directly when needed:

public class OrderService
{
    private readonly IValidationProvider _validator;

    public OrderService(IValidationProvider validator)
    {
        _validator = validator;
    }

    public async Task CreateOrder(CreateOrderDto dto)
    {
        var outcome = await _validator.ValidateAsync(dto, throwOnFaults: true);

        // If throwOnFaults is false, inspect the outcome manually
        if (!outcome.IsValid)
        {
            foreach (var fault in outcome.Errors)
            {
                Console.WriteLine($"{fault.PropertyName}: {fault.ErrorMessage}");
            }
        }
    }
}

Key Types

Documentation

For full documentation, visit rcommon.com.

Related Packages

• RCommon.ApplicationServices - Core validation abstractions (IValidationProvider, ValidationOutcome, ValidationFault)
• RCommon.Core - RCommon framework core and DI builder

License

Licensed under the Apache License, Version 2.0.