🛠 ساخت متدهای Extension برای ادغام آسان

حالا بیایید چند extension method بسازیم تا استفاده از FluentValidation در Options Pattern راحت‌تر شود:

public static class OptionsBuilderExtensions
{
    public static OptionsBuilder<TOptions> ValidateFluentValidation<TOptions>(
        this OptionsBuilder<TOptions> builder)
        where TOptions : class
    {
        builder.Services.AddSingleton<IValidateOptions<TOptions>>(
            serviceProvider => new FluentValidateOptions<TOptions>(
                serviceProvider,
                builder.Name));

        return builder;
    }
}

این extension method به ما امکان می‌دهد هنگام کانفیگ Options، متد ()ValidateFluentValidation را فراخوانی کنیم، مشابه متد داخلی ()ValidateDataAnnotations.

برای راحتی بیشتر، می‌توانیم یک extension method دیگر بسازیم تا کل فرآیند کانفیگ را ساده کند:

public static class ServiceCollectionExtensions
{
    public static IServiceCollection AddOptionsWithFluentValidation<TOptions>(
        this IServiceCollection services,
        string configurationSection)
        where TOptions : class
    {
        services.AddOptions<TOptions>()
            .BindConfiguration(configurationSection)
            .ValidateFluentValidation() // کانفیگ FluentValidation
            .ValidateOnStart(); // اعتبارسنجی در هنگام شروع برنامه

        return services;
    }
}

📝 ثبت و استفاده از اعتبارسنجی

چند روش برای استفاده از این ادغام FluentValidation وجود دارد:

1️⃣: ثبت استاندارد با ثبت دستی Validator

// ثبت Validator
builder.Services.AddScoped<IValidator<GitHubSettings>, GitHubSettingsValidator>();

// کانفیگ Options با اعتبارسنجی
builder.Services.AddOptions<GitHubSettings>()
    .BindConfiguration(GitHubSettings.ConfigurationSection)
    .ValidateFluentValidation() // فعال کردن FluentValidation
    .ValidateOnStart();

2️⃣: استفاده از Extension راحت

// ثبت Validator
builder.Services.AddScoped<IValidator<GitHubSettings>, GitHubSettingsValidator>();

// استفاده از Extension راحت
builder.Services.AddOptionsWithFluentValidation<GitHubSettings>(GitHubSettings.ConfigurationSection);

3️⃣: ثبت خودکار Validatorها
اگر Validatorهای زیادی دارید و می‌خواهید همه را یکجا ثبت کنید، می‌توانید از assembly scanning استفاده کنید:

// ثبت همه Validatorها از assembly
builder.Services.AddValidatorsFromAssembly(typeof(Program).Assembly);

// استفاده از Extension راحت
builder.Services.AddOptionsWithFluentValidation<GitHubSettings>(GitHubSettings.ConfigurationSection);

⚡️ اتفاقات هنگام اجرای برنامه

با ()ValidateOnStart، اگر هر قانونی نقض شود، برنامه هنگام startup یک استثنا پرتاب می‌کند.
مثال: اگر در appsettings.json مقدار AccessToken موجود نباشد، پیام خطا شبیه زیر خواهد بود:

Microsoft.Extensions.Options.OptionsValidationException:
    Validation failed for GitHubSettings.AccessToken with the error: 'Access Token' must not be empty.

این کار از شروع برنامه با پیکربندی اشتباه جلوگیری می‌کند و اطمینان حاصل می‌کند که مشکلات در اوایل چرخه توسعه شناسایی شوند. ✅