👨‍💻 IOptions vs IOptionsSnapshot vs IOptionsMonitor

В .NET существует несколько интерфейсов для работы с настройками: IOptions, IOptionsSnapshot и IOptionsMonitor. Помогаем разобраться, какой из них когда нужен.

IOptions — загружает конфигурацию однажды при запуске и всегда возвращает одно и то же значение:

public class MyService
{
    private readonly MySettings _settings;

    public MyService(IOptions<MySettings> options)
    {
        _settings = options.Value;
    }

    public void PrintSettings()
    {
        Console.WriteLine($"API Key: {_settings.ApiKey}");
    }
}

Это подходит для статичных настроек, которые не меняются во время работы приложения.

IOptionsSnapshot — создаётся на каждый запрос или скоуп и предоставляет новые значения при каждом новом запросе:

public class MyScopedService
{
    private readonly MySettings _settings;

    public MyScopedService(IOptionsSnapshot<MySettings> options)
    {
        _settings = options.Value;
    }

    public void PrintSettings()
    {
        Console.WriteLine($"Timeout: {_settings.Timeout}");
    }
}

Подходит для веб-приложений, где конфигурация может меняться между запросами.

IOptionsMonitor — позволяет подписаться на изменения и получать обновления конфигурации в реальном времени:

public class MyMonitorService
{
    private MySettings _settings;

    public MyMonitorService(IOptionsMonitor<MySettings> monitor)
    {
        _settings = monitor.CurrentValue;
        monitor.OnChange(updatedSettings =>
        {
            _settings = updatedSettings;
            Console.WriteLine("Settings updated!");
        });
    }

    public void PrintSettings()
    {
        Console.WriteLine($"LogLevel: {_settings.LogLevel}");
    }
}

Подходит для длительно работающих приложений, которые должны реагировать на изменения конфигурации без перезапуска.

🐸Библиотека шарписта

#sharp_view