Шаблоны фабрики и параметров
Используйте делегаты фабрики, IServiceProvider и шаблон параметров для работы с условными или настраиваемыми зависимостями.
«Шаблоны фабрики и параметров» — бесплатный урок C# Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения C# Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс C# Academy содержит 4 уроков всего.
Когда внедрения через конструктор недостаточно
Иногда службы необходимо создавать условно, на основе данных во время выполнения, или по-разному настраивать для разных сценариев использования. В таких случаях особенно полезны фабричные шаблоны и шаблон параметров.
Фабричные делегаты с AddTransient
Вы можете передать фабричный делегат в AddTransient, AddScoped или AddSingleton. Делегат получает IServiceProvider, поэтому может получать другие службы.
builder.Services.AddTransient<IPaymentGateway>(sp =>
{
var config = sp.GetRequiredService<IOptions<PaymentConfig>>().Value;
return config.Provider == "stripe"
? new StripeGateway(config.ApiKey)
: new PayPalGateway(config.ClientId, config.Secret);
});Именованные параметры с обновлением для каждого запроса
Шаблон параметров связывает разделы конфигурации со строго типизированными классами. Используйте IOptions<T> для одиночных служб и IOptionsSnapshot<T> для значений, обновляемых для каждого запроса.
public class SmtpSettings
{
public string Host { get; set; } = "";
public int Port { get; set; } = 587;
public string Username { get; set; } = "";
}
// Registration
builder.Services.Configure<SmtpSettings>(
builder.Configuration.GetSection("Smtp"));
// Consumption
public class EmailService
{
private readonly SmtpSettings _settings;
public EmailService(IOptions<SmtpSettings> opts)
=> _settings = opts.Value;
}Мониторинг параметров для горячей перезагрузки
IOptionsMonitor<T> предоставляет текущее значение параметра в момент обращения и уведомляет об изменениях конфигурации — это идеально для одиночных служб, которым нужны актуальные обновления конфигурации.
public class FeatureFlagService
{
private readonly IOptionsMonitor<FeatureFlags> _monitor;
public FeatureFlagService(IOptionsMonitor<FeatureFlags> monitor)
=> _monitor = monitor;
public bool IsEnabled(string flag)
{
// Always reads the latest config value
return _monitor.CurrentValue.Flags.GetValueOrDefault(flag);
}
}Именованные параметры
Именованные параметры позволяют зарегистрировать несколько конфигураций одного типа. Используйте Configure<T>(name, ...), а получайте нужную конфигурацию с помощью IOptionsSnapshot<T>.Get(name).
builder.Services.Configure<S3Settings>("primary",
builder.Configuration.GetSection("S3:Primary"));
builder.Services.Configure<S3Settings>("backup",
builder.Configuration.GetSection("S3:Backup"));
public class S3Service
{
public S3Service(IOptionsSnapshot<S3Settings> opts)
{
var primary = opts.Get("primary");
var backup = opts.Get("backup");
}
}Проверка параметров при запуске
Используйте ValidateDataAnnotations() или специальный валидатор, чтобы убедиться в корректности конфигурации до запуска приложения. Для немедленного обнаружения ошибок объедините это с ValidateOnStart().
public class SmtpSettings
{
[Required] public string Host { get; set; } = "";
[Range(1, 65535)] public int Port { get; set; } = 587;
}
builder.Services
.AddOptions<SmtpSettings>()
.Bind(builder.Configuration.GetSection("Smtp"))
.ValidateDataAnnotations()
.ValidateOnStart();Шаблон абстрактной фабрики
Интерфейс абстрактной фабрики позволяет внедрить фабрику в службы и отложить создание до появления данных во время выполнения, не создавая прямой зависимости от поставщика служб.
public interface IReportFactory
{
IReport Create(string reportType);
}
public class ReportFactory : IReportFactory
{
private readonly IServiceProvider _sp;
public ReportFactory(IServiceProvider sp) => _sp = sp;
public IReport Create(string reportType) => reportType switch
{
"pdf" => _sp.GetRequiredService<PdfReport>(),
"excel"=> _sp.GetRequiredService<ExcelReport>(),
_ => throw new ArgumentException("Unknown type")
};
}
builder.Services.AddTransient<IReportFactory, ReportFactory>();Службы с ключами (.NET 8)
В .NET 8 появились службы с ключами: зарегистрируйте несколько реализаций под разными ключами и получите нужную с помощью [FromKeyedServices] или GetKeyedService.
builder.Services.AddKeyedScoped<IPaymentGateway, StripeGateway>("stripe");
builder.Services.AddKeyedScoped<IPaymentGateway, PayPalGateway>("paypal");
// Resolve in a class:
public class CheckoutService(
[FromKeyedServices("stripe")] IPaymentGateway stripe,
[FromKeyedServices("paypal")] IPaymentGateway paypal) { }PostConfigure для переопределений
PostConfigure выполняется после всех вызовов Configure. Используйте его для применения переопределений в проверках или для обеспечения инвариантов независимо от загруженной конфигурации.
// In integration tests: force test values after real config
builder.Services.PostConfigure<SmtpSettings>(opts =>
{
opts.Host = "smtp.test.local";
opts.Port = 25;
});Методы расширения коллекции служб
Соберите регистрации в методы расширения, чтобы сохранить Program.cs чистым и сделать модули повторно используемыми в разных проектах.
public static class ServiceCollectionExtensions
{
public static IServiceCollection AddPaymentServices(
this IServiceCollection services,
IConfiguration config)
{
services.Configure<PaymentConfig>(config.GetSection("Payment"));
services.AddScoped<IPaymentGateway, StripeGateway>();
services.AddScoped<PaymentService>();
return services;
}
}
// Usage in Program.cs:
builder.Services.AddPaymentServices(builder.Configuration);Практический пример: уведомления через несколько поставщиков
Используя фабрику и именованные параметры вместе, вы можете выбрать подходящего поставщика уведомлений во время выполнения на основе предпочтения пользователя, сохранённого в базе данных.
builder.Services.AddKeyedScoped<INotifier, EmailNotifier>("email");
builder.Services.AddKeyedScoped<INotifier, SmsNotifier>("sms");
builder.Services.AddKeyedScoped<INotifier, PushNotifier>("push");
public class NotificationService
{
private readonly IServiceProvider _sp;
public NotificationService(IServiceProvider sp) => _sp = sp;
public Task SendAsync(string channel, string message)
{
var notifier = _sp.GetRequiredKeyedService<INotifier>(channel);
return notifier.SendAsync(message);
}
}Быстрая проверка
Какой интерфейс предоставляет текущее значение параметров AND уведомляет об изменениях конфигурации, благодаря чему подходит для одиночных служб?
Итоги: шаблоны фабрики и параметров
Главное:
- Фабричные делегаты в методах
Add*позволяют создавать службы условно или на основе настроек во время выполнения - Шаблон параметров связывает разделы конфигурации со строго типизированными обычными классами
IOptions= статические значения,IOptionsSnapshot= значения для каждого запроса,IOptionsMonitor= актуальные обновления- Проверяйте параметры при запуске с помощью
ValidateDataAnnotations().ValidateOnStart() - Службы с ключами (.NET 8) заменяют обходные решения с фабриками для именованных реализаций
Часто задаваемые вопросы
Урок «Шаблоны фабрики и параметров» бесплатный?
Да — полный текст урока «Шаблоны фабрики и параметров» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс C# Academy, подпишись на CoddyKit PRO. Курс C# Academy содержит 4 уроков всего.
Чему я научусь в уроке «Шаблоны фабрики и параметров»?
Используйте делегаты фабрики, IServiceProvider и шаблон параметров для работы с условными или настраиваемыми зависимостями. Ты практикуешь C# Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать C# Academy?
Предыдущий опыт не требуется. C# Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.
Сколько времени занимает урок «Шаблоны фабрики и параметров»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке C# Academy?
Да. Каждый урок C# Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Основы контейнера внедрения зависимостей
- Время жизни служб: Transient, Scoped, Singleton
- Внедрение через конструктор и интерфейсы
- Шаблоны фабрики и параметров